Quickstart

This guide will get you ready to use the Cobrofácil API. We'll cover how to generate an API token, choose an HTTP client or SDK, and make your first request.

Choose your client

You can call the API with any HTTP client or use one of the official Cobrofácil SDKs.

# cURL is most likely already installed on your machine
curl --version

Making your first API request

After choosing an HTTP client or SDK, make a request to the transactions endpoint. The endpoint requires a date range and returns Laravel-style paginated results. You can optionally filter by a client's external_reference.

curl -G https://api.cobrofacil.com/api/v1/transactions \
  -H "Authorization: Bearer {token}" \
  -H "X-Environment: sandbox" \
  -d start_date=2026-01-01 \
  -d end_date=2026-01-31 \
  -d page=1

What's next?

Here are the next docs to read as you build your integration:

• Generate and use bearer tokens
• Explore official SDKs
• Learn about the different error messages in Cobrofácil