Referências
- Empréstimos
- GETObter empréstimo
- GETListar empréstimos
- GETPesquisar empréstimos
- GETListar parcelas
- GETListar passos da esteira de empréstimos
- POSTAtualizar empréstimo
- POSTCriar empréstimo
- POSTCancelar empréstimo
- POSTAnular empréstimo
- POSTMarcar empréstimo como expirado
- POSTAlterar o estado de um empréstimo para aberto
- POSTDesembolsar empréstimo
- POSTCriar transação
- POSTCriar parcela
- POSTMarcar empréstimo como pendente
- POSTAnexar arquivo ao empréstimo
- POSTAssinar empréstimo
- DELExcluir empréstimo
- DELDesanexar arquivo do empréstimo
- GET
- Empresas
- Políticas de crédito
- Esteira
- Clientes
- Funcionários
- Fundos
- Eventos
- Produtos
- Ofertas
- Assinaturas
- Grupos de empresas
- Operadores
- Permissões
- Itens da fatura
- Intenções de pagamento
- Métodos de pagamento
- Parcelas
- Webhooks externos
- Links de arquivos
- Arquivos
- Faturas
- Temas
- Chaves da API
- Configurações
- Entidade de dados
- Documentos
- Workflows
- Notificações
- Modelos
Pesquisar empréstimos
Pesquise empréstimos que você criou anteriormente usando a linguagem de query.
curl --request GET \
--url https://api.base39.io/v1/loans/search \
--header 'Authorization: Bearer <token>'
{
"hasMore": true,
"data": [
{
"id": "loan_5f92f01728e009f403d8502e",
"status": "open",
"externalId": "4eeb7525-40c6-45fe-8236-2b731d740fad",
"employment": "<string>",
"customer": "<string>",
"company": "<string>",
"contractNumber": "AB123456789",
"cashout": [
{
"amount": 123,
"paymentMethod": "<string>",
"type": "payment_method"
}
],
"offer": {
"id": "offr_5f92f01728e009f403d8502e",
"disbursementAmount": 123,
"installmentAmount": 123,
"totalAmount": 123,
"interestAmount": 123,
"iofAmount": 123,
"iofAdditionalAmount": 123,
"monthlyCET": 0.02,
"yearlyCET": 0.12,
"monthlyFee": 0.02,
"yearlyFee": 0.12,
"insurance": {
"amount": 123,
"fee": 0.02,
"type": "required",
"number": "<string>",
"insurer": "<string>"
},
"interestType": "<string>",
"creditOperationType": "<string>",
"expectedDisbursementDate": "2023-12-25",
"interestGracePeriod": 123,
"principalGracePeriod": 123,
"numberOfInstallments": 123,
"firstDueDate": "2023-12-25",
"fund": "fund_637b85aaa8e91c82fd053aac",
"product": "prod_637cf14e316408250c0bd067",
"description": "<string>",
"rebates": [
{
"feeType": "tac",
"amountType": "absolute",
"amount": 200,
"description": "<string>"
}
],
"fine": {
"fineRate": 0.02,
"interestBase": "workdays",
"monthlyRate": 0.02
},
"cashout": [
{
"amount": 123,
"paymentMethod": "<string>",
"type": "<string>"
}
],
"creditPolicy": "crpl_637b85aaa8e91c82fd053aac",
"metadata": {},
"createdAt": "2023-08-25T22:38:41.134Z"
},
"transactions": [
{
"amount": 123,
"description": "<string>",
"createdAt": "2023-12-25"
}
],
"attachments": [
{
"file": "file_6307b6c39f5d3d917009b631",
"linkedAt": "2023-11-07T05:31:56Z"
}
],
"context": {
"ip": "<string>",
"headers": {},
"fingerprint": "<string>",
"geolocation": [
"<string>"
]
},
"history": [
{
"description": "<string>",
"status": "open",
"metadata": {},
"createdAt": "2023-08-25T22:38:41.134Z"
}
],
"signatures": [
{
"signer": "<string>",
"context": {
"id": "sign_5f92f01728e009f403d8502e",
"signedAt": "2023-12-25",
"metadata": {},
"context": {
"ip": "<string>",
"headers": {},
"fingerprint": "<string>",
"geolocation": [
"<string>"
]
}
}
}
],
"amountRemaining": 1500,
"amountForPayment": 1487.9,
"isRefinancing": false,
"metadata": {},
"createdAt": "2023-08-25T22:38:41.134Z",
"updatedAt": "2023-08-25T22:38:41.134Z",
"deleted": false
}
]
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Uma string de busca que permite criar filtros personalizados. Filtros permitidos customer.id
, company.id
, customer.document
, company.document
, id
, status
, externalId
, createdAt
, steps.slug
, steps.status
, steps.type
, steps.methodData.type
, steps.methodData.role
. Para os campos que são string o único comparador válido é :
. Para campos do tipo data ou números são permitidos os comparadores =
, >
, <
, >=
e <=
. É possível utilizar os operadores AND
e OR
para concatenar mais de uma query, O operador lógico AND
tem prioridade de agrupamento em relação ao OR
. É possível utilizar os caracteres ()
para definir prioridade de agrupamentos.
Expande as referências.
Pode ser um valor único ou uma lista separada por vírgula (csv) de referências retornadas neste endpoint.
Um cursor para uso na paginação. starting_after
é um ID de objeto que define seu lugar na lista. Por exemplo, se você fizer uma solicitação de lista e receber 100 objetos, terminando com obj_foo
, sua chamada subsequente poderá incluir starting_after=obj_foo
para buscar a próxima página da lista.
Um cursor para uso na paginação. starting_after
é um ID de objeto que define seu lugar na lista. Por exemplo, se você fizer uma solicitação de lista e receber 100 objetos, terminando com obj_foo
, sua chamada subsequente poderá incluir starting_after=obj_foo
para buscar a próxima página da lista.
Um limite no número de objetos a serem retornados. O limite pode variar entre 1 e 100, e o padrão é 10.
Response
Uma lista de empréstimos.
Informa se existem mais itens. Os próximos itens podem ser obtidos informando o ID do último item no startingAfter
.
Uma lista de empréstimos
Identificador exclusivo para o objeto.
Status do empréstimo
Id do vinculo empregatício ou um objeto com os dados do vinculo empregatício nas operações de leitura quando usado o modo expand.
Id do cliente ou um objeto com os dados do cliente nas operações de leitura quando usado o modo expand.
Id da empresa ou um objeto com os dados da empresa nas operações de leitura quando usado o modo expand.
Número do contrato
Este objeto representa uma oferta de um empréstimo.
Identificador exclusivo para o objeto.
Valor solicitado
Valor da parcela.
Valor total da dívida. Inclui tarifas, impostos, valor desembolsado, IOF, taxas e juros.
Valor total dos Juros.
Valor total do IOF (Imposto sobre Operações Financeiras).
Valor da taxa única da [alíquota adicional do IOF (Imposto sobre Operações Financeiras) (decreto 6.339/08).
Custo efetivo total ao mês. O valor deve ser definido em base decimal, por exemplo, defina 0.02 para representar 2% a.m.
Custo efetivo total ao ano. O valor deve ser definido em base decimal, por exemplo, defina 0.12 para representar 12% a.a.
Taxa mensal. O valor deve ser definido em base decimal, por exemplo, defina 0.02 para representar 2% a.m.
Taxa anual. O valor deve ser definido em base decimal, por exemplo, defina 0.12 para representar 12% a.m.
Definição do seguro vinculado a oferta de empréstimo.
Taxa. O valor deve ser definido em base decimal, por exemplo, defina 0.02 para representar 2%.
required
, optional
, uninsured
Tipo de juros aplicado na dívida.
Tipo de operação de crédito
Data de desembolso no padrão ISO 8601
Data do primeiro vencimento
Identificador que faz referência a um fundo.
Identificador do produto no qual este empréstimo foi criado.
Tipo da tarifa.
registration
: utilizado para indicar tarifas ou taxas de manutenção.
tac
: utilizado para representar taxas de cadastro ou Taxa de Contratação (TC).
tac
, spread
, registration
Tipo do valor a ser cobrado
absolute
, percentage
Valor da tarifa.
Descrição para a tarifa.
Definição de multa.
Valor percentual fixo da multa. O valor deve ser definido em base decimal, por exemplo, defina 0.02 para representar 2%.
Contagem do tempo para multa (calendar
para dias corridos e workdays
para dias úteis)
workdays
, calendarDays
Valor percentual mensal da multa. O valor deve ser definido em base decimal, por exemplo, defina 0.02 para representar 2%.
Política de crédito utilizada para a oferta
Conjunto de pares de valores-chave que podem ser anexados a um objeto. Isso pode ser útil para armazenar informações adicionais sobre o objeto em um formato estruturado.
Data de criação do objeto
Status do empréstimo
Conjunto de pares de valores-chave que podem ser anexados a um objeto. Isso pode ser útil para armazenar informações adicionais sobre o objeto em um formato estruturado.
Data de criação do objeto
Signatário do empréstimo. Pode ser um customer
ou operator
.
Identificador exclusivo para o objeto.
Conjunto de pares de valores-chave que podem ser anexados a um objeto. Isso pode ser útil para armazenar informações adicionais sobre o objeto em um formato estruturado.
Informação do contexto da operação. Usado para segurança e formalização. IP, Headers, Fingerprint, and Geolocation
Valor restante para pagamento, será apresentado caso seja informado o parâmetro payment_for.
Valor para pagamento, será apresentado caso seja informado o parâmetro payment_for.
Este campo informa se o empréstimo é um refinanciamento. Ele é preenchido automaticamente, levando em conta os dados do campo cashout
, e não pode ser preenchido de forma manual.
Conjunto de pares de valores-chave que podem ser anexados a um objeto. Isso pode ser útil para armazenar informações adicionais sobre o objeto em um formato estruturado.
Data de criação do objeto
Data de alteração do objeto
Identifica se o objeto foi excluído. Se verdadeiro, o objeto foi excluído.
curl --request GET \
--url https://api.base39.io/v1/loans/search \
--header 'Authorization: Bearer <token>'
{
"hasMore": true,
"data": [
{
"id": "loan_5f92f01728e009f403d8502e",
"status": "open",
"externalId": "4eeb7525-40c6-45fe-8236-2b731d740fad",
"employment": "<string>",
"customer": "<string>",
"company": "<string>",
"contractNumber": "AB123456789",
"cashout": [
{
"amount": 123,
"paymentMethod": "<string>",
"type": "payment_method"
}
],
"offer": {
"id": "offr_5f92f01728e009f403d8502e",
"disbursementAmount": 123,
"installmentAmount": 123,
"totalAmount": 123,
"interestAmount": 123,
"iofAmount": 123,
"iofAdditionalAmount": 123,
"monthlyCET": 0.02,
"yearlyCET": 0.12,
"monthlyFee": 0.02,
"yearlyFee": 0.12,
"insurance": {
"amount": 123,
"fee": 0.02,
"type": "required",
"number": "<string>",
"insurer": "<string>"
},
"interestType": "<string>",
"creditOperationType": "<string>",
"expectedDisbursementDate": "2023-12-25",
"interestGracePeriod": 123,
"principalGracePeriod": 123,
"numberOfInstallments": 123,
"firstDueDate": "2023-12-25",
"fund": "fund_637b85aaa8e91c82fd053aac",
"product": "prod_637cf14e316408250c0bd067",
"description": "<string>",
"rebates": [
{
"feeType": "tac",
"amountType": "absolute",
"amount": 200,
"description": "<string>"
}
],
"fine": {
"fineRate": 0.02,
"interestBase": "workdays",
"monthlyRate": 0.02
},
"cashout": [
{
"amount": 123,
"paymentMethod": "<string>",
"type": "<string>"
}
],
"creditPolicy": "crpl_637b85aaa8e91c82fd053aac",
"metadata": {},
"createdAt": "2023-08-25T22:38:41.134Z"
},
"transactions": [
{
"amount": 123,
"description": "<string>",
"createdAt": "2023-12-25"
}
],
"attachments": [
{
"file": "file_6307b6c39f5d3d917009b631",
"linkedAt": "2023-11-07T05:31:56Z"
}
],
"context": {
"ip": "<string>",
"headers": {},
"fingerprint": "<string>",
"geolocation": [
"<string>"
]
},
"history": [
{
"description": "<string>",
"status": "open",
"metadata": {},
"createdAt": "2023-08-25T22:38:41.134Z"
}
],
"signatures": [
{
"signer": "<string>",
"context": {
"id": "sign_5f92f01728e009f403d8502e",
"signedAt": "2023-12-25",
"metadata": {},
"context": {
"ip": "<string>",
"headers": {},
"fingerprint": "<string>",
"geolocation": [
"<string>"
]
}
}
}
],
"amountRemaining": 1500,
"amountForPayment": 1487.9,
"isRefinancing": false,
"metadata": {},
"createdAt": "2023-08-25T22:38:41.134Z",
"updatedAt": "2023-08-25T22:38:41.134Z",
"deleted": false
}
]
}