Lista parceiros com filtros e paginação

Produção

https://gtw.unnotech.com.br/public

GET

/api/v1/partners

Lista paginada de parceiros aos quais o caller tem acesso (filtragem por hierarquia).

Filtros

full_name — busca parcial case-insensitive em full_name.

cpf_cnpj — busca parcial em cpf_cnpj (aceita CPF ou CNPJ, apenas dígitos).

Múltiplos filtros são combinados com AND (todos precisam bater).

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`)

Formato 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,desc

campo — nome do field em snake_case (created_at, full_name, cpf_cnpj, …).

direcao — asc ou desc. Default quando omitido: asc.

Default geral quando sort não é informado: created_at,desc.

Requisição

Authorization

JWT Bearer

Adicionar o parâmetro

Authorization

a Cabeçalhos

Exemplo:

Authorization: ********************

Parâmetros de Consulta

Parâmetros Header

Respostas

🟢200

application/json

Lista paginada.

Bodyapplication/json

🟠401

🟠403

🔴500

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 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-06-09 20:35:05

Página anterior

Gera um access_token

Próxima página

Cadastra um novo parceiro

Lista parceiros com filtros e paginação

Filtros#

Paginação#

Ordenação (parâmetro sort)#

Requisição

Respostas

Filtros

Paginação

Ordenação (parâmetro `sort`)