1. Autenticação
Docs Unnotech
  • Visão geral da API
  • Guia: Originação FGTS
  • Usuários
    • Lista usuários com filtros e paginação
      GET
    • Cadastra um novo usuário
      POST
    • Detalha um usuário pelo UUID
      GET
    • Remove um usuário
      DELETE
    • Atualiza um usuário (parcial)
      PATCH
  • Parceiros
    • Lista parceiros com filtros e paginação
      GET
    • Cadastra um novo parceiro
      POST
    • Detalha um parceiro pelo UUID
      GET
    • Remove um parceiro
      DELETE
    • Atualiza um parceiro (parcial)
      PATCH
  • Originação FGTS
    • Busca applications pelo id externo do consumidor
      GET
    • Cria uma solicitação (application) e dispara a cotação
      POST
    • Re-cota uma application (ofertas antigas invalidadas)
      POST
    • Aceita uma oferta e inicia a contratação
      POST
    • Lê o KYC (pré-preenchido quando disponível na plataforma)
      GET
    • Submete o KYC (cadastro completo) exigido antes do aceite
      POST
    • Detalha uma application pelo id
      GET
    • Status enxuto da application (para polling)
      GET
  • Autenticação
    • Gera um access_token
      POST
  • Propostas
    • Lista propostas com filtros e paginação
      GET
    • Detalha uma proposta pelo UUID
      GET
  • Grupos
    • Lista grupos disponíveis
      GET
  • Esquemas
    • CreateUserRequest
    • CreateUserResponse
    • Data
    • CreateUserResponseData
    • BankerizeErrorResponse
    • Address
    • BankAccount
    • CreatePartnerRequest
    • Partner
    • Pix
    • CreatePartnerResponse
    • CreateFgtsApplicationRequest
    • CreatePartnerResponseData
    • Customer
    • ApiError
    • ApiErrorCode
    • ApiErrorResponse
    • ErrorDetail
    • FieldErrorCode
    • ApplicationStatus
    • FgtsApplication
    • FgtsInstallment
    • FgtsOffer
    • FgtsQuote
    • OfferStatus
    • QuoteStatus
    • RejectionKind
    • RejectionReason
    • AcceptFgtsOfferRequest
    • AcceptFgtsOfferResponse
    • AccountType
    • CivilStatus
    • DisbursementMethod
    • FgtsKyc
    • FgtsKycAddress
    • FgtsKycBank
    • Gender
    • PixKeyType
    • TokenRequest
    • TokenResponse
    • OAuth2ErrorResponse
    • UpdateUserRequest
    • Group
    • UserDetail
    • UserDetailResponse
    • UserPartnerEntry
    • UpdatePartnerRequest
    • PartnerDetail
    • PartnerDetailResponse
    • PageInfo
    • SortInfo
    • UserListItem
    • UsersPage
    • ProposalsPage
    • PublicProposalListItem
    • PublicCustomerSummary
    • PublicDisbursementAccount
    • PublicLoanSummary
    • PublicProposalDetail
    • PublicProposalDetailResponse
    • PartnerListItem
    • PartnersPage
    • ListOfGroupsResponse
    • FgtsApplicationList
    • FgtsApplicationStatus
  1. Autenticação

Gera um access_token

POST
/api/v1/auth/token
Troca um par client_id / client_secret por um access_token JWT.
O token retornado deve ser enviado no header Authorization: Bearer <token>
nas demais chamadas da API Pública. O tempo de vida do token é definido no
campo expires_in (em segundos) — solicite um novo após expirar.

Erros comuns#

CódigoCausa
invalid_requestBody malformado ou campos obrigatórios ausentes
invalid_clientclient_id inexistente ou client_secret incorreto
server_errorFalha temporária — repita com backoff

Requisição

Authorization
JWT Bearer
Adicionar o parâmetro
Authorization
a Cabeçalhos
Exemplo:
Authorization: ********************
or
Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200
application/json
Token gerado com sucesso.
Bodyapplication/json

🟠400
🟠401
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://gtw.unnotech.com.br/public/api/v1/auth/token' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "client_id": "minha-empresa-prod",
    "client_secret": "S3cr3t0Ult4Secret0"
}'
Response Response Example
200 - Sucesso
{
    "access_token": "eyJhbGciOiJSUzI1NiIs...",
    "token_type": "Bearer",
    "expires_in": 3600,
    "scope": "internal"
}
Modificado em 2026-07-28 02:36:49
Página anterior
Status enxuto da application (para polling)
Próxima página
Lista propostas com filtros e paginação
Built with