Seam Docs
API Reference
The Seam API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

Request/Response Format

All request submitting parameters must set their Content-Type to application/json. Nonconforming requests will not be accepted.
You can set your request content-type by adding the Content-Type: application/json header to your Seam API request.
The default response format is JSON. Successful requests will return a 200 OK HTTP status.
Some general information about responses:
  • Dates are returned in ISO8601 format: YYYY-MM-DDTHH:MM:SS.
  • Resource IDs are returned as integers or uuids.
Perform an Action


All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail (see Authentication Section).


Seam uses conventional HTTP response codes to indicate the success or failure of an API request.
In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, a resource is not authorized for writes, etc.). Codes in the 5xx range indicate an error with Seam's servers (these are rare).
Below are a few examples of such errors:
Status Code
Bad Request -- Your request is invalid.
Unauthorized -- Couldn't authenticate your request
Invalid scope -- User hasn’t authorized necessary scope
Internal Server Error -- Server error