The Degreed API uses the following error codes:

Error Code

Meaning

400

Bad Request. Your request is invalid.

This error displays when posting the client authentication request and the client credentials or scopes are incorrect. Commonly, you have attempted to assign scopes to an access_token that its API key does not possess.

Please verify the client credentials and scopes.

401

Unauthorized. Your API key is invalid.

403

Forbidden. You don't have the rights to visit this resource.

This may be because the owner of the record may have marked it private.

404

Not Found. The resource could not be found.

405

Method Not Allowed. You tried to access a resource with an invalid method.

406

Not Acceptable. The format is not valid. We only accept JSON.

410

Gone. The resource requested has been removed from our servers.

429

Too Many Requests. You have submitted too many requests.

Degreed limits the number of calls a single API client can make to 70 requests per minute (rpm). If you exceed the limit, this response is returned. See Rate Limiting for more information.

500

Internal Server Error. We had a problem with our server. Try again later.

503

Service Unavailable. Possibilities include that:
(a) We're temporarily offline for maintenance.
(b) Our service is currently experiencing a very high volume of demand.

You can write your application to retry the attempt 30-120 seconds later and likely resolve the problem.


Did this page help you?