Guidis Reinf

Reinf API documentation

The Guidis Reinf Reinf API covers the full EFD-Reinf operation: authentication, context, registrations, event submission, messaging, webhooks, reports, receipts and proofs. The same public integration is used by the portal, by SDKs and by AI agents.

The API is REST and uses bearer token authentication: you exchange the API key for a short-lived access token. There is a versioned public OpenAPI and a technical playground to test the calls.

What this documentation unlocks

This documentation is written for the fiscal integrator who needs to move from the technical credential to the real operation, without guessing where each part begins. It covers authentication, first call, EFD-Reinf messaging, submissions, webhooks, reports and access to the technical playground.

The integration also accepts official spreadsheets and AI-agent workflows. Claude Code, Codex and your own agents can read assessment files on the user machine, such as XML, PDF, Excel, CSV and supporting documents, before organizing submission data and operating EFD-Reinf through the API.

Minimum integrator flow

  1. Create the API key - generate the API key in the portal, under Administration > Access Control > API Integrations. It is displayed only once, on creation.
  2. Get the token - exchange the API key for an access token at POST /api/integracao/token, sending the key in the Authorization: Bearer header.
  3. Validate the context - start with GET /v1/integracao/contexto and confirm the account is ready.
  4. Submit and track - register data, submit events and track batches, webhooks and reports.
POST /api/integracao/token
Authorization: Bearer YOUR_API_KEY

Next steps

Playground and contract

Use the playground to browse endpoints and test authentication. The public OpenAPI contract is the base for SDKs, automations and integrations with external tools.

  • Technical playground to execute real API calls
  • Public OpenAPI specification for download
  • Same bearer token authentication used by HTTP clients, starting from the API key
  • Useful base for automations with Claude Code, Codex and your own agents