Lista parceiros com filtros e paginação
GET
/api/v1/partners
Filtros
full_name — busca parcial case-insensitive em full_name.cpf_cnpj — busca parcial em cpf_cnpj (aceita CPF ou CNPJ, apenas dígitos).Paginação
page — base 0 (a primeira página é page=0).size — entre 1 e 100 (valores acima de 100 são capados em 100).Ordenação (parâmetro sort)
campo,direcao, repetível para ordenar por múltiplos campos:GET /api/v1/partners?sort=created_at,desc
GET /api/v1/partners?sort=full_name,asc&sort=created_at,desccampo — nome do field em snake_case (created_at, full_name, cpf_cnpj, …).direcao — asc ou desc. Default quando omitido: asc.sort não é informado: created_at,desc.Requisição
Parâmetros de Consulta
Parâmetros Header
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://gtw.unnotech.com.br/public/api/v1/partners?page=0&size=20&full_name=fulano&cpf_cnpj=12345678&sort=full_name%2Casc' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Exemplo 1
{
"content": [
{
"partner_id": "3ea1d784-4c6f-4dd0-bfa3-5e027c172fd1",
"name": "Fulano de Tal",
"status": "active",
"email": "fulano@detal.com.br",
"phone": "11987654321",
"document_number": "12345678901",
"person_type": "pf",
"created_at": "2026-05-08T13:45:00Z",
"parent_id": "a52a555d-68f8-4560-b544-8ebc76a447ac"
}
],
"page": {
"number": 0,
"size": 20,
"total_elements": 142,
"total_pages": 8
},
"sort": [
{
"property": "created_at",
"direction": "asc"
}
]
}Modificado em 2026-08-18 04:28:10