Presscart API Documentation

GET /outlets

Added filters[most_popular] — return records sorted by most ordered.
Added filters[new_last_30_days] — return records created within the last 30 days, sorted by newest first.

GET /outlets/{outlet_id}/products

Added filters[most_popular] and filters[new_last_30_days] quick filters (same as GET /outlets).

POST /orders/checkout

Response now includes checkout_link — a shareable guest checkout URL so customers can pay online without needing an internal team member to send the link.

GET /orders/{order_id}

Response now includes checkout_link when the order status is not PAID (otherwise null).

GET /orders

Each order record now includes checkout_link when the order status is not PAID (otherwise null).

Articles endpoints (new)

GET /articles/{article_id} — Get article details including brief and draft Google Doc links.
PUT /articles/{article_id} — Update an article's content brief via brief_google_doc_url.
PATCH /articles/{article_id}/approve-brief — Approve a content brief.
PATCH /articles/{article_id}/approve-draft — Submit and approve a draft via draft_google_doc_url in a single step.

Files & Folders endpoints (new)

GET /files — List files in your team's media library (paginated, searchable, folder-filterable).
GET /files/{file_id} — Get a file with a signed URL.
POST /files/upload — Upload 1–5 files via multipart/form-data.
GET /files/{file_id}/download — Download a file's binary content.
POST /files/move — Move files between folders (or back to root).
DELETE /files/{file_id} — Soft-delete a file.
GET /folders — List folders.
POST /folders — Create a folder.
PATCH /folders/{folder_id} — Rename a folder.
DELETE /folders/{folder_id} — Soft-delete a folder.

Documentation

Fixed filters[disclaimer_id] to filters[disclaimer] in GET /outlets — the filter uses disclaimer name, not ID.
Fixed GET /outlet-disclaimers description to reference name values instead of id values for filtering.
Fixed GET /products/categories response example — category types now use correct casing (FULL_FEATURE, PRESS_RELEASE, NEWSLETTER, SOCIAL).
Fixed POST /orders/checkout — linked_order_line_item_id and discount are now correctly marked as optional. Initial order status corrected from PENDING to CREATED.
Fixed GET /campaigns list response — corrected articles[].order_item shape to include nested outlet and addons fields. Added search filter.
Fixed GET /campaigns/{campaign_id}/articles response — removed incorrect pagination fields (total_pages, current_page, next_page, previous_page). Only records and total_records are returned.
Fixed GET /teams/{team_id}/profiles response — removed fields not returned by the API (nylas_user_id, pitchbox_project_id, media_assets_visited, v1_profile_id, hubspot_id).

GET /tags (new)

GET /outlet-disclaimers (new)

GET /outlets

Changed filters[disclaimer] (name) to filters[disclaimer_id] (ID). Use the disclaimer ID from GET /outlet-disclaimers.

GET /outlets

Added outlet_id field to each record. Use this when calling GET /outlets/{outlet_id}.
The existing id field remains the product ID.
Added filter support: channel_type, placement_type, is_do_follow, is_indexed, disclaimer, tags, country, state, city, pricing, domain_authority, domain_ranking, turnaround_time.
Documented default values for limit, page, sort_by, and order_by.

GET /outlets/{outlet_id}

GET /outlets/{outlet_id}/products (new)

Location endpoints (new)

GET /outlets/locations/countries — list all distinct countries.
GET /outlets/locations/states?country= — list states for a country.
GET /outlets/locations/cities?country=&state= — list cities, optionally filtered by state.
Country values use full names (e.g. United States, not US).

Documentation

Added full response examples with all fields across all API reference pages (orders, campaigns, profiles, products).
Added Axios code examples for all endpoints.

Changelog