Listar compradores conhecidos

GET /api/v1/quotation/{company_role_id}/buyers

O que este endpoint faz

Este endpoint retorna uma lista de compradores conhecidos, respeitando o contexto e os filtros declarados na rota. Ele pertence ao domínio de criação, revisão e acompanhamento de cotações de antecipação de recebíveis.

Use GET /api/v1/quotation/{company_role_id}/buyers quando a integração precisar acionar esse comportamento exatamente como o app da Antecipa Fácil faz pelo gateway público. A rota depende de company_role_id, então a chamada deve ser feita no contexto correto da empresa, título ou recurso informado.

Para que serve

Ele ajuda a compor fluxos de integração do backend do parceiro com a plataforma, mantendo autenticação via Bearer token e tráfego pelo APIM. Consulte os parâmetros, corpo de requisição e respostas desta página antes de usar em produção.

Gateway

Chame sempre https://api.antecipafacil.net.br/api/v1/quotation/{company_role_id}/buyers. O APIM repassa a rota para o backend correto; serviços internos não devem ser chamados diretamente.

Parâmetros

company_role_id path obrigatório

Valor usado para compor a chamada deste endpoint.

Respostas

200 Operação executada com sucesso.

Try it GET

URL Bearer token Try it!

Clique em Try it! para executar a chamada pelo navegador.

Exemplos

ShellNodeDenoPythonC#Rust

curl --request GET \
  --url 'https://api.antecipafacil.net.br/api/v1/quotation/123/buyers' \
  --header 'accept: application/json' \
  --header 'Authorization: Bearer <access_token>'

const response = await fetch('https://api.antecipafacil.net.br/api/v1/quotation/123/buyers', {
  method: 'GET',
  headers: {
    accept: 'application/json',
    Authorization: 'Bearer <access_token>',
  },
});

const data = await response.json();
console.log(data);

const response = await fetch('https://api.antecipafacil.net.br/api/v1/quotation/123/buyers', {
  method: 'GET',
  headers: {
    accept: 'application/json',
    Authorization: 'Bearer <access_token>',
  },
});

console.log(await response.json());

import requests

url = "https://api.antecipafacil.net.br/api/v1/quotation/123/buyers"
headers = {
    "accept": "application/json",
    "Authorization": "Bearer <access_token>",
}

response = requests.get(url, headers=headers)
response.raise_for_status()
print(response.json())

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://api.antecipafacil.net.br/api/v1/quotation/123/buyers");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", "<access_token>");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

let client = reqwest::Client::new();
let response = client
    .request(reqwest::Method::GET, "https://api.antecipafacil.net.br/api/v1/quotation/123/buyers")
    .bearer_auth("<access_token>")
    .header("accept", "application/json")
    .send()
    .await?;

let body = response.text().await?;
println!("{}", body);

Copiar exemplo