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, eCommerce, Logistics, Shipping, and Returns.

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

34.7/100 thin ▬ flat Agent 41/100 agent aware Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessSelf serve
12 APIs
CompanyeCommerceLogisticsShippingReturnsOrder TrackingPost-PurchaseCustomer ExperienceFulfillment

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 34.7/100 · thin
Contract Quality 10.0 / 25
Developer Ergonomics 7.8 / 20
Commercial Clarity 6.8 / 20
Operational Transparency 0.0 / 13
Governance 0.0 / 12
Discoverability 10.0 / 10
Agent readiness — 41/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
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
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 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

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

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

Access & Security 2

Authentication, authorization, and security posture

Operate 1

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 1

The organization behind the API

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.20'
created: '2026-07-17'
modified: '2026-07-20'
tags:
- 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:
  - 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: 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