API reference · Accounts
Get an account
GET/v1/accounts/{accountId}
No description in the spec yet.
Requires a Bearer access token.
Parameters
1 of 7 fields has no description in the spec.
accountId#stringin pathrequiredincludeSites#booleanin queryInclude sites
includeParentAccount#booleanin queryInclude parent account
includeBillingInfo#booleanin queryInclude billing info
includeFiscalInfo#booleanin queryInclude fiscal info
includeMetrics#booleanin queryInclude metrics
Required in the spec, optional for the API.
includeDonorPlatform#booleanin queryInclude donor platform
Required in the spec, optional for the API.
Response
200 · AccountNo field is described in the spec.
accountId#stringalways returnedname#stringalways returnedstatus#AccountStatusalways returnedPENDINGVALIDATEDCLOSEDtype#AccountTypealways returnedINDIVIDUALCOMPANYlogoUrl#stringfaviconUrl#stringtitleColor#stringaccentColor#stringheadcount#stringauthSchemes#AuthScheme[]always returnedparentAccountId#stringlinkedAccountId#stringcreatedAt#string (date-time)always returnedupdatedAt#string (date-time)always returned
Errors
400A field is missing, has the wrong type, or is not part of the request schema.
Every request with a body or query is validated.
{ "statusCode": 400, "message": [ "amount must not be less than 1", "property foo should not exist" ], "error": "Bad Request" }401Unauthorized
Missing, expired or invalid access token.
{ "statusCode": 401, "message": "Unauthorized" }403Forbidden
{ "statusCode": 403, "message": "Forbidden" }403Account closed
{ "message": "Account closed", "code": "ACCOUNT_CLOSED" }404Not Found
No resource with this id on your account: the API answers as if it did not exist.
{ "statusCode": 404, "message": "Not Found" }
curl -X GET https://api.sandbox.charitips.com/v1/accounts/<accountId> \ -H "Authorization: Bearer $CHARITIPS_TOKEN"Request bodies are written for this docs and checked against the API's validation; ids in angle brackets are placeholders. Response values are placeholders built from the schema.