API Reference

Complete reference for all Presscart public API endpoints, conventions, and response formats.

Base URL for all endpoints:

https://api.presscart.com

Common conventions

Authentication

All requests require a bearer token. See Authentication for setup.

Team scoping

API tokens are bound to a team. When accessing team-owned resources (orders, profiles, campaigns), the API automatically filters results to your team. You cannot access resources belonging to other teams.

Pagination

Most list endpoints accept these query parameters:

ParameterDescription
limitNumber of records per page
pagePage number
sort_byField to sort by
order_bySort direction (asc or desc)
include_archivedInclude archived records

Most paginated responses use this envelope:

{
  "records": [],
  "total_records": 0,
  "total_pages": 0,
  "current_page": 1,
  "next_page": null,
  "previous_page": null
}

Exceptions:

  • GET /profiles/\{profile_id\}/order-items returns a raw array instead of a pagination envelope

Sanitized responses

Some responses are sanitized for API-token callers. Internal pricing fields (such as internal_cost and reseller_price) are removed or nulled.

Endpoint groups

On this page