Listar Agendamentos

Utilize este endpoint para listar os agendamentos (schedulings) gerados por um saque recorrente.

Cada saque recorrente gera um agendamento por execução prevista, de acordo com a frequência e a duração informadas na criação.

Ambientes Disponíveis

Produção

https://api.gateway.com.br/core

Endpoint

• Método: GET
• Endpoint: /recurring-withdrawal/{id}/schedulings
• Autenticação: Bearer token

Path Params

Nome	Tipo	Obrigatório	Descrição	Validações
id	string (UUID)	Sim	Identificador do saque recorrente	Deve ser UUID válido

Exemplo de Requisição

cURL

curl --request GET \
--url https://api.gateway.com.br/core/recurring-withdrawal/553e8400-e29b-41d4-a716-436251480000/schedulings \
--header 'Authorization: Bearer seu-token-jwt'

JavaScript

const response = await fetch('https://api.gateway.com.br/core/recurring-withdrawal/553e8400-e29b-41d4-a716-436251480000/schedulings', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer seu-token-jwt'
  }
});
const data = await response.json();

Resposta de Sucesso

Campo	Tipo	Obrigatório	Descrição
total	number	Sim	Total de itens
totalPages	number	Sim	Total de páginas
currentPage	number	Sim	Página atual
perPage	number	Sim	Itens por página
data	array	Sim	Lista de agendamentos

Campos do item em data

Campo	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	Identificador único do agendamento
status	string (enum) - SCHEDULED, PROCESSED, FAILED, CANCELED	Sim	SCHEDULED: Aguardando a data prevista para execução PROCESSED: Saque processado com sucesso FAILED: Erro ao processar o saque CANCELED: Agendamento cancelado (ex.: saque recorrente cancelado)
amount	number	Sim	Valor do saque (inteiro em centavos)
description	string	Sim	Descrição do saque
scheduledDate	string (ISO)	Sim	Data prevista para execução

Exemplo de Resposta

{
  "total": 12,
  "totalPages": 1,
  "currentPage": 1,
  "perPage": 15,
  "data": [
    {
      "id": "663e8400-e29b-41d4-a716-446655440001",
      "status": "SCHEDULED",
      "amount": 10000,
      "description": "Repasse mensal para fornecedor",
      "scheduledDate": "2027-02-05T12:00:00.000Z"
    }
  ]
}

Possíveis Erros

Código	Descrição	Solução
401	Credenciais inválidas	Verifique suas credenciais
403	Sem permissão/autorização	Contate o suporte
404	Registro não encontrado	Verifique o id informado
422	Dados inválidos ou faltando	Verifique o formato dos dados
500	Erro interno	Contate o suporte