Primeiras requisições

Estes exemplos usam curl, mas qualquer cliente HTTP funciona. Substitua SECRET_ID e SECRET_PASSWORD pelas suas chaves de API; o curl -u monta o cabeçalho Authorization: Basic para você.

1. Liste as instituições disponíveis

curl -u "SECRET_ID:SECRET_PASSWORD" \
  "https://api.datanomik.com/v1/institutions?country=BR"

Cada instituição tem um code (por exemplo BRADESCO), que você usa para criar um link. Para ver as credenciais que uma instituição exige, chame GET /v1/institutions/{id}.

2. Liste seus links

curl -u "SECRET_ID:SECRET_PASSWORD" \
  "https://api.datanomik.com/v1/links?page=0&size=50"

A resposta é paginada:

{
  "content": [
    {
      "id": "b0f8ccb9-aad8-4fe9-a531-cd6ddd04cae2",
      "institution": "BRADESCO",
      "country": "BR",
      "status": "ACTIVE",
      "accessed_at": "2026-10-23T09:12:44Z"
    }
  ],
  "page_number": 0,
  "page_size": 50,
  "total_elements": 1,
  "total_pages": 1,
  "first": true,
  "last": true
}

3. Leia as contas e os saldos de um link

curl -u "SECRET_ID:SECRET_PASSWORD" \
  "https://api.datanomik.com/v1/accounts?linkId=b0f8ccb9-aad8-4fe9-a531-cd6ddd04cae2"

curl -u "SECRET_ID:SECRET_PASSWORD" \
  "https://api.datanomik.com/v1/balances?linkId=b0f8ccb9-aad8-4fe9-a531-cd6ddd04cae2"

4. Leia as transações de um período

curl -u "SECRET_ID:SECRET_PASSWORD" \
  "https://api.datanomik.com/v1/transactions?linkId=b0f8ccb9-aad8-4fe9-a531-cd6ddd04cae2&dateFrom=2026-10-01&dateTo=2026-10-22&page=0&size=100"

Se você não enviar dateFrom, a API retorna as transações dos últimos 60 dias.

Próximos passos

Siga o fluxo de integração completo, incluindo como criar links e mantê-los atualizados.
Teste cada endpoint pela Referência da API: informe suas chaves no quadro Authentication e clique em Try It!.