Authentication
Authenticate with the Snippe API using API keys
All API requests require authentication using an API key in the Authorization header.
Authorization: Bearer snp_your_api_key_hereGetting Your API Key
- Log in to your Snippe Dashboard
- Go to Settings → API Keys
- Click Create API Key
- Copy and store your key securely
Your API key is only shown once. Store it securely immediately.
Example Request
curl -X GET https://api.snippe.sh/v1/payments \
-H "Authorization: Bearer snp_your_api_key_here"Scopes
| Scope | Description |
|---|---|
collection:read | View payments and balance |
collection:create | Create payment intents |
disbursement:read | View payouts |
disbursement:create | Create payouts |
Error Responses
Invalid or Missing API Key (401)
{
"status": 401,
"error": {
"code": "invalid_api_key",
"message": "Invalid API key"
}
}Insufficient Scope (403)
{
"status": 403,
"error": {
"code": "insufficient_scope",
"message": "API key does not have required scope: disbursement:create"
}
}