Authentication

To use the API you need an API key from your RCUR account. You can create one on the integrations page. API access is part of the RCUR plans that include integrations; on other plans every request is answered with 403 Upgrade your account to use the API.

Sending your API key

Send the key with every request in the Authorization header, using the Bearer scheme:

Authorization: Bearer xsDOtmnkVtjNVWXLSlXsM

Also send Accept: application/json. Without it, a request with a missing or invalid key is redirected to the RCUR login page instead of receiving a JSON 401 response.

curl https://rcur.app/api/v2/customers/YJRQAMRQ6y \
  -H "Authorization: Bearer xsDOtmnkVtjNVWXLSlXsM" \
  -H "Accept: application/json"

Keeping your key safe

An API key gives full access to your organization's customers, subscriptions and payments. Keep it on your server: never put it in front-end code, a mobile app or a public repository. If a key may have leaked, revoke it on the integrations page and create a new one.