PRIMIS

Primis (Primis CX) is a post-purchase customer experience platform for eCommerce retailers, headquartered in the UK and backed by 500 Global. Its products — Primis Track (branded order tracking), Primis Ship (discounted multi-carrier shipping), Primis Returns (label-less returns processing), and Primis International (cross-border logistics across 120+ carriers) — reduce "where is my order?" support volume and drive repeat purchases. Primis exposes a REST API (OpenAPI 3.0.0, 42 operations) over HTTPS with bearer-token authentication, covering retailers, orders, shipments, products, campaigns, billing, users, tracking pages, FAQs, and documents, and integrates with Shopify, BigCommerce, Adobe Commerce/Magento, WooCommerce, and carriers such as DPD, DHL, USPS, Evri, UPS, and FedEx.

PRIMIS publishes 12 APIs on the APIs.io network, including Auth API, Billing API, Campaign API, and 9 more. Tagged areas include Company, E-Commerce, Logistics, Shipping, and Returns.

PRIMIS’s developer surface includes authentication, documentation, API reference, pricing, signup flow, support, and 9 more developer resources.

🌐 Visit website 📡 Source on GitHub
36.6/100 thin ▬ flat Agent 26/100 agent aware Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0
AccessSelf serve
12 APIs 1 MCP Servers
CompanyE-CommerceLogisticsShippingReturnsOrder TrackingPost-PurchaseCustomer ExperienceFulfillment

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0
Composite quality — 36.6/100 · thin
Contract Quality 11.1 / 25
Developer Ergonomics 8.6 / 20
Access Clarity 6.8 / 20
Operational Transparency 0.0 / 13
Contract Governance 2.0 / 12
Discoverability 8.2 / 10
Agent readiness — 26/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
Documented Reversibility 0 / 6
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/primis: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 12

Individual APIs this provider publishes, each with its own machine-readable definition.

PRIMIS Auth API

The Auth API from PRIMIS — 6 operation(s) for auth.

PRIMIS Billing API

Billing API

PRIMIS Campaign API

Campaign API

PRIMIS Document API

Documents API

PRIMIS FAQ API

FAQ API

PRIMIS Index API

Index API

PRIMIS Invitation API

The Invitation API from PRIMIS — 3 operation(s) for invitation.

PRIMIS Order API

Order API

PRIMIS Product API

Product API

PRIMIS Retailer API

Retailer API

PRIMIS Tracking API

Tracking Context API

PRIMIS User API

User API

Scroll for all 12

Open Collections 13

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

REST Auth API

OPEN COLLECTION

REST Auth Billing API

OPEN COLLECTION

REST Auth Campaign API

OPEN COLLECTION

REST Auth Document API

OPEN COLLECTION

REST Auth FAQ API

OPEN COLLECTION

REST Auth Index API

OPEN COLLECTION

REST Auth Invitation API

OPEN COLLECTION

REST Auth Order API

OPEN COLLECTION

REST Auth Product API

OPEN COLLECTION

REST Auth Retailer API

OPEN COLLECTION

REST Auth Tracking API

OPEN COLLECTION

REST Auth User API

OPEN COLLECTION

Scroll for all 13

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

PRIMIS MCP Server

MCP SERVER

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Primis Authentication

http · 1 scheme

SECURITY

Primis Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Primis Agentic Access

42 operations · 25 acting · 1 human-in-the-loop

42 operations · 25 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 SignUp
SignUp
 Login
Login

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

MCPServer
MCPServer
 AgenticAccess
AgenticAccess
 LLMsTxt
LLMsTxt

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication

Operate 1

Status, limits, changes, and where to get help

Support
Support

Commercial 2

Pricing, plans, and the legal terms of use

Pricing
Pricing
 PrivacyPolicy
PrivacyPolicy

Company 1

The organization behind the API

Website
Website

Other 1

Properties that don't map to a standard resource type

Overlay
Overlay

Source (apis.yml)

apis.yml Raw ↑ 
aid: primis
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/primis.png
name: PRIMIS
description: Primis (Primis CX) is a post-purchase customer experience platform for eCommerce retailers, headquartered in
  the UK and backed by 500 Global. Its products — Primis Track (branded order tracking), Primis Ship (discounted multi-carrier
  shipping), Primis Returns (label-less returns processing), and Primis International (cross-border logistics across 120+
  carriers) — reduce "where is my order?" support volume and drive repeat purchases. Primis exposes a REST API (OpenAPI 3.0.0,
  42 operations) over HTTPS with bearer-token authentication, covering retailers, orders, shipments, products, campaigns,
  billing, users, tracking pages, FAQs, and documents, and integrates with Shopify, BigCommerce, Adobe Commerce/Magento, WooCommerce,
  and carriers such as DPD, DHL, USPS, Evri, UPS, and FedEx.
url: https://raw.githubusercontent.com/api-evangelist/primis/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- 500-global
x-tier: provider
x-tier-reason: live-openapi-discovered
specificationVersion: '0.23'
created: '2026-07-17'
modified: '2026-07-20'
tags:
- Company
- E-Commerce
- Logistics
- Shipping
- Returns
- Order Tracking
- Post-Purchase
- Customer Experience
- Fulfillment
tags_raw:
- Company
- eCommerce
- Logistics
- Shipping
- Returns
- Order Tracking
- Post-Purchase
- Customer Experience
- Fulfillment
apis:
- aid: primis:primis-auth-api
  name: PRIMIS Auth API
  description: The Auth API from PRIMIS — 6 operation(s) for auth.
  humanURL: https://api.primis.cx/api-docs
  baseURL: https://api.primis.cx
  tags:
  - Authentication
  tags_raw:
  - Auth
  properties:
  - type: OpenAPI
    url: openapi/primis-auth-api-openapi.yml
  - type: APIReference
    url: https://api.primis.cx/api-docs
  - type: Conventions
    url: conventions/primis-conventions.yml
  - type: ErrorCatalog
    url: errors/primis-problem-types.yml
  - type: DataModel
    url: data-model/primis-data-model.yml
  - type: Lifecycle
    url: lifecycle/primis-lifecycle.yml
  - type: Conformance
    url: conformance/primis-conformance.yml
  - type: Sandbox
    url: sandbox/primis-sandbox.yml
- aid: primis:primis-billing-api
  name: PRIMIS Billing API
  description: Billing API
  humanURL: https://api.primis.cx/api-docs
  baseURL: https://api.primis.cx
  tags:
  - Billing
  properties:
  - type: OpenAPI
    url: openapi/primis-billing-api-openapi.yml
  - type: APIReference
    url: https://api.primis.cx/api-docs
  - type: Conventions
    url: conventions/primis-conventions.yml
  - type: ErrorCatalog
    url: errors/primis-problem-types.yml
  - type: DataModel
    url: data-model/primis-data-model.yml
  - type: Lifecycle
    url: lifecycle/primis-lifecycle.yml
  - type: Conformance
    url: conformance/primis-conformance.yml
  - type: Sandbox
    url: sandbox/primis-sandbox.yml
- aid: primis:primis-campaign-api
  name: PRIMIS Campaign API
  description: Campaign API
  humanURL: https://api.primis.cx/api-docs
  baseURL: https://api.primis.cx
  tags:
  - Campaign
  properties:
  - type: OpenAPI
    url: openapi/primis-campaign-api-openapi.yml
  - type: APIReference
    url: https://api.primis.cx/api-docs
  - type: Conventions
    url: conventions/primis-conventions.yml
  - type: ErrorCatalog
    url: errors/primis-problem-types.yml
  - type: DataModel
    url: data-model/primis-data-model.yml
  - type: Lifecycle
    url: lifecycle/primis-lifecycle.yml
  - type: Conformance
    url: conformance/primis-conformance.yml
  - type: Sandbox
    url: sandbox/primis-sandbox.yml
- aid: primis:primis-document-api
  name: PRIMIS Document API
  description: Documents API
  humanURL: https://api.primis.cx/api-docs
  baseURL: https://api.primis.cx
  tags:
  - Document
  properties:
  - type: OpenAPI
    url: openapi/primis-document-api-openapi.yml
  - type: APIReference
    url: https://api.primis.cx/api-docs
  - type: Conventions
    url: conventions/primis-conventions.yml
  - type: ErrorCatalog
    url: errors/primis-problem-types.yml
  - type: DataModel
    url: data-model/primis-data-model.yml
  - type: Lifecycle
    url: lifecycle/primis-lifecycle.yml
  - type: Conformance
    url: conformance/primis-conformance.yml
  - type: Sandbox
    url: sandbox/primis-sandbox.yml
- aid: primis:primis-faq-api
  name: PRIMIS FAQ API
  description: FAQ API
  humanURL: https://api.primis.cx/api-docs
  baseURL: https://api.primis.cx
  tags:
  - FAQ
  properties:
  - type: OpenAPI
    url: openapi/primis-faq-api-openapi.yml
  - type: APIReference
    url: https://api.primis.cx/api-docs
  - type: Conventions
    url: conventions/primis-conventions.yml
  - type: ErrorCatalog
    url: errors/primis-problem-types.yml
  - type: DataModel
    url: data-model/primis-data-model.yml
  - type: Lifecycle
    url: lifecycle/primis-lifecycle.yml
  - type: Conformance
    url: conformance/primis-conformance.yml
  - type: Sandbox
    url: sandbox/primis-sandbox.yml
- aid: primis:primis-index-api
  name: PRIMIS Index API
  description: Index API
  humanURL: https://api.primis.cx/api-docs
  baseURL: https://api.primis.cx
  tags:
  - Index
  properties:
  - type: OpenAPI
    url: openapi/primis-index-api-openapi.yml
  - type: APIReference
    url: https://api.primis.cx/api-docs
  - type: Conventions
    url: conventions/primis-conventions.yml
  - type: ErrorCatalog
    url: errors/primis-problem-types.yml
  - type: DataModel
    url: data-model/primis-data-model.yml
  - type: Lifecycle
    url: lifecycle/primis-lifecycle.yml
  - type: Conformance
    url: conformance/primis-conformance.yml
  - type: Sandbox
    url: sandbox/primis-sandbox.yml
- aid: primis:primis-invitation-api
  name: PRIMIS Invitation API
  description: The Invitation API from PRIMIS — 3 operation(s) for invitation.
  humanURL: https://api.primis.cx/api-docs
  baseURL: https://api.primis.cx
  tags:
  - Invitation
  properties:
  - type: OpenAPI
    url: openapi/primis-invitation-api-openapi.yml
  - type: APIReference
    url: https://api.primis.cx/api-docs
  - type: Conventions
    url: conventions/primis-conventions.yml
  - type: ErrorCatalog
    url: errors/primis-problem-types.yml
  - type: DataModel
    url: data-model/primis-data-model.yml
  - type: Lifecycle
    url: lifecycle/primis-lifecycle.yml
  - type: Conformance
    url: conformance/primis-conformance.yml
  - type: Sandbox
    url: sandbox/primis-sandbox.yml
- aid: primis:primis-order-api
  name: PRIMIS Order API
  description: Order API
  humanURL: https://api.primis.cx/api-docs
  baseURL: https://api.primis.cx
  tags:
  - Order
  properties:
  - type: OpenAPI
    url: openapi/primis-order-api-openapi.yml
  - type: APIReference
    url: https://api.primis.cx/api-docs
  - type: Conventions
    url: conventions/primis-conventions.yml
  - type: ErrorCatalog
    url: errors/primis-problem-types.yml
  - type: DataModel
    url: data-model/primis-data-model.yml
  - type: Lifecycle
    url: lifecycle/primis-lifecycle.yml
  - type: Conformance
    url: conformance/primis-conformance.yml
  - type: Sandbox
    url: sandbox/primis-sandbox.yml
- aid: primis:primis-product-api
  name: PRIMIS Product API
  description: Product API
  humanURL: https://api.primis.cx/api-docs
  baseURL: https://api.primis.cx
  tags:
  - Product
  properties:
  - type: OpenAPI
    url: openapi/primis-product-api-openapi.yml
  - type: APIReference
    url: https://api.primis.cx/api-docs
  - type: Conventions
    url: conventions/primis-conventions.yml
  - type: ErrorCatalog
    url: errors/primis-problem-types.yml
  - type: DataModel
    url: data-model/primis-data-model.yml
  - type: Lifecycle
    url: lifecycle/primis-lifecycle.yml
  - type: Conformance
    url: conformance/primis-conformance.yml
  - type: Sandbox
    url: sandbox/primis-sandbox.yml
- aid: primis:primis-retailer-api
  name: PRIMIS Retailer API
  description: Retailer API
  humanURL: https://api.primis.cx/api-docs
  baseURL: https://api.primis.cx
  tags:
  - Retailer
  properties:
  - type: OpenAPI
    url: openapi/primis-retailer-api-openapi.yml
  - type: APIReference
    url: https://api.primis.cx/api-docs
  - type: Conventions
    url: conventions/primis-conventions.yml
  - type: ErrorCatalog
    url: errors/primis-problem-types.yml
  - type: DataModel
    url: data-model/primis-data-model.yml
  - type: Lifecycle
    url: lifecycle/primis-lifecycle.yml
  - type: Conformance
    url: conformance/primis-conformance.yml
  - type: Sandbox
    url: sandbox/primis-sandbox.yml
- aid: primis:primis-tracking-api
  name: PRIMIS Tracking API
  description: Tracking Context API
  humanURL: https://api.primis.cx/api-docs
  baseURL: https://api.primis.cx
  tags:
  - Tracking
  properties:
  - type: OpenAPI
    url: openapi/primis-tracking-api-openapi.yml
  - type: APIReference
    url: https://api.primis.cx/api-docs
  - type: Conventions
    url: conventions/primis-conventions.yml
  - type: ErrorCatalog
    url: errors/primis-problem-types.yml
  - type: DataModel
    url: data-model/primis-data-model.yml
  - type: Lifecycle
    url: lifecycle/primis-lifecycle.yml
  - type: Conformance
    url: conformance/primis-conformance.yml
  - type: Sandbox
    url: sandbox/primis-sandbox.yml
- aid: primis:primis-user-api
  name: PRIMIS User API
  description: User API
  humanURL: https://api.primis.cx/api-docs
  baseURL: https://api.primis.cx
  tags:
  - User
  properties:
  - type: OpenAPI
    url: openapi/primis-user-api-openapi.yml
  - type: APIReference
    url: https://api.primis.cx/api-docs
  - type: Conventions
    url: conventions/primis-conventions.yml
  - type: ErrorCatalog
    url: errors/primis-problem-types.yml
  - type: DataModel
    url: data-model/primis-data-model.yml
  - type: Lifecycle
    url: lifecycle/primis-lifecycle.yml
  - type: Conformance
    url: conformance/primis-conformance.yml
  - type: Sandbox
    url: sandbox/primis-sandbox.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: MCPServer
  url: mcp/primis-mcp.yml
- type: Overlay
  url: overlays/primis-openapi-overlay.yaml
- type: AgenticAccess
  url: agentic-access/primis-agentic-access.yml
- type: DomainSecurity
  url: security/primis-domain-security.yml
- type: Authentication
  url: authentication/primis-authentication.yml
- type: Website
  url: https://primis.cx
- type: DeveloperPortal
  url: https://api.primis.cx/api-docs
- type: Documentation
  url: https://api.primis.cx/api-docs
- type: APIReference
  url: https://api.primis.cx/api-docs
- type: Pricing
  url: https://primis.cx/pricing/
- type: SignUp
  url: https://retailer.primis.cx
- type: Login
  url: https://retailer.primis.cx
- type: Support
  url: https://primis.cx/contact-us/
- type: PrivacyPolicy
  url: https://primis.cx/privacy-centre/
- type: Integrations
  url: https://primis.cx/integrations/
- type: LLMsTxt
  url: llms/primis-llms.txt
x-enrichment:
  date: '2026-07-20'
  status: enriched
  artifacts_added: 13
  pass: local-v1