#Getting Started

#1. Get credentials

Request a client ID and client secret from your Finity integration contact. Use separate credentials for sandbox and production.

#2. Request an access token

curl -X POST https://sandbox.dev.finity.com.co/v0/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{"grant_type":"client_credentials","client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

The response contains an access_token, token_type, and expiration time. Treat the access token as a secret and request a new one when it expires.

#3. Call a protected endpoint

curl https://sandbox.dev.finity.com.co/v0/rates?from=USD\&to=COP \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

#4. Continue with your workflow

Use the API reference to inspect required parameters, examples, response codes, and the available operation groups.