Consultar repasses

GET/v1/repasses

🔒 Requer Bearer token

Escopo repasses:read. Lista os repasses/pagamentos dos contratos no período informado (proxy filtrado da consulta Socinal — só retorna contratos do próprio parceiro). Use contrato para consultar uma única CCB. repassado: true indica que a IF já efetuou o repasse. Sem registros retorna { "repasses": [] }.

Parâmetros

contratostringqueryopcional

Número da CCB (contrato) do parceiro. Quando informado, a consulta é restrita a este contrato; se o contrato não pertencer ao parceiro, retorna 404.

data_iniciostringqueryopcional

Início da janela de busca (YYYY-MM-DD). Default: janela padrão do backend.

padrão: ^\d{4}-\d{2}-\d{2}$

data_fimstringqueryopcional

Fim da janela de busca (YYYY-MM-DD). Default: hoje.

padrão: ^\d{4}-\d{2}-\d{2}$

Respostas

Corpo da resposta 200

repassesarray<object>obrigatório

contratostringobrigatório

competenciastringobrigatório

valor_parcela_paganumberobrigatório

numero_guiaintegerobrigatório

nsuintegerobrigatório

data_pagamento_guiastring<date-time>obrigatório

data_inclusao_dataprevstring<date-time>obrigatório

data_repasse_ifstring<date-time>obrigatórionullable

repassadobooleanobrigatório

Request

curl -X GET 'https://econsignado-api.socinal.com.br/v1/repasses?contrato=valor&data_inicio=valor&data_fim=valor' \
  -H 'Authorization: Bearer SEU_TOKEN'

Response

{
  "repasses": [
    {
      "contrato": "A100001-001",
      "competencia": "202506",
      "valor_parcela_paga": 312.45,
      "numero_guia": 998877,
      "nsu": 4455667,
      "data_pagamento_guia": "2025-06-05T00:00:00.000Z",
      "data_inclusao_dataprev": "2025-06-06T00:00:00.000Z",
      "data_repasse_if": "2025-06-10T00:00:00.000Z",
      "repassado": true
    }
  ]
}