Careem POS API

Name: Careem POS API API
Brand: Careem POS API
Availability: InStock

✓ Official Vendor SpecE CommerceOrder Managementoauth224 EndpointsREST

For Agents

Manage Careem Food brands, branches, menu catalogs, operational hours, and live orders for a restaurant POS integration via OAuth 2.0.

Quickstart

Get started with Careem POS API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"list careem orders for a branch"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Careem POS API API.

Create, list, fetch, update, and delete restaurant brands on Careem

Onboard branches and toggle their POS integration and SuperApp visibility status

Publish or reset a full menu catalog and update item availability per branch

Set and fetch branch operational hours including time-bound visibility windows

GET STARTED

Start building with Careem POS API API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Careem POS API API for, with concrete tasks.

★ Restaurant POS Integration

Connect a restaurant POS to Careem Food so orders flow into the kitchen system without manual re-entry. The PUT /catalogs endpoint pushes the menu, GET /orders returns live orders, PUT /orders/{order_id} progresses state from accepted through ready, and PUT /orders/{order_id}/delay-request asks for more prep time when needed. This eliminates the manual tablet-style operation Careem flags as the core problem in its API overview.

Poll GET /orders for a branch, accept any new orders by calling PUT /orders/{order_id}, and tag each with the local POS ticket number.

Menu and Catalog Management

Keep menus in sync between an internal product database and the Careem SuperApp. Use PUT /catalogs to publish a full catalog as a single transaction, GET /catalogs/status/{request_id} to confirm processing, and PATCH /catalogs/{catalog_id}/items to flip individual items in or out of stock without resending the whole menu. This avoids the disconnects that lead to canceled orders.

Submit an updated catalog payload via PUT /catalogs, poll the request_id until success, then mark item ITEM-22 unavailable at branch BR-7.

Branch Operations Control

Drive branch state changes from a back-office tool: open or close a branch on the SuperApp, set time-bound closures (e.g., 'closed for 30 minutes'), and update operational hours. POST /branches/{branch_id}/visibility/status and /visibility/status/expiries handle real-time visibility, while PUT /operational-hours covers regular weekly schedules. PATCH /branches/{branch_id}/status toggles the underlying POS integration when a branch goes offline.

Set branch BR-3 to closed for 30 minutes on the SuperApp during an unexpected kitchen issue.

AI Agent Order Operations via Jentic

Wire Careem POS into an operations agent through Jentic so a restaurant manager can ask 'are there any orders waiting more than 5 minutes?' and the agent answers with action. Jentic returns the right operation, holds the OAuth client credentials in its vault, and exposes order, branch, and catalog endpoints as a single tool surface for any framework.

Through Jentic, list orders for branch BR-3, find any in 'accepted' state for over 5 minutes, and request a delay extension on each.

Key Endpoints

24 endpoints — careem pos api connects restaurant point-of-sale systems to the careem food / superapp marketplace, automating brand and branch setup, menu catalog publishing, operational hours, and live order flow.

METHOD

PATH

DESCRIPTION

POST

/token

Generate an OAuth access token

GET

/orders

List orders

GET

/orders/{order_id}

Fetch an order by ID

PUT

/orders/{order_id}

Update order state

PUT

/orders/{order_id}/delay-request

Request more preparation time

PUT

/catalogs

Create or update the full menu catalog

PATCH

/catalogs/{catalog_id}/items

Update item availability

POST

/branches/{branch_id}/visibility/status

Update branch status on the SuperApp

POST

/token

Generate an OAuth access token

GET

/orders

List orders

GET

/orders/{order_id}

Fetch an order by ID

PUT

/orders/{order_id}

Update order state

PUT

/orders/{order_id}/delay-request

Request more preparation time

PUT

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Careem OAuth client_id/client_secret pairs are stored encrypted in Jentic's vault. Agents receive scoped execution rights only — Jentic exchanges them at the Careem token endpoint and injects the resulting access token at request time, so secrets never enter the agent's prompt or chat logs.

Intent-based discovery

Agents search Jentic by intent (e.g., 'update careem order state' or 'mark a menu item out of stock') and Jentic returns the matching Careem POS operation with its input schema, so the agent picks the right endpoint without browsing the developer portal.

Time to first call

Direct Careem POS integration: 1-2 weeks for OAuth flow, catalog publishing, webhook handling, and order state machine across 24 endpoints. Through Jentic: under 2 hours — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Carrier Lookup

Phone number carrier and line-type lookup useful for order verification.

Use alongside Careem POS when validating customer phone numbers attached to incoming orders.

Alternative

Careerjet Job Search

Unrelated job search aggregator; included as a disambiguator.

Do not select for restaurant operations — Careerjet handles job postings, not food delivery.

Complementary

CarbonAPI

Calculates delivery and supplier emissions for ESG reporting.

Pair when reporting the carbon footprint of food delivery operations alongside order volumes.

FAQs

Specific to using Careem POS API API through Jentic.

What authentication does the Careem POS API use?

Careem POS uses OAuth 2.0 client credentials. POST a client_id and client_secret to https://identity.careem.com/token (or the spec's POST /token equivalent) to receive an access token with the `pos` scope, then send it as a bearer token. Through Jentic the client credentials are stored encrypted in the credential vault and the access token is fetched and refreshed automatically.

Can I push a full menu catalog through the Careem POS API?

Yes. PUT /catalogs accepts the full menu as a single payload and returns a request_id. Poll GET /catalogs/status/{request_id} for the upload result, then use PATCH /catalogs/{catalog_id}/items to flip individual items in or out of stock without re-sending the whole catalog.

How do I close a branch temporarily on the Careem SuperApp?

Call POST /branches/{branch_id}/visibility/status to toggle the branch on or off, or POST /branches/{branch_id}/visibility/status/expiries to set a closed window with a specific duration (for example, 30 minutes during a kitchen rush). Both endpoints affect what customers see in the SuperApp immediately.

What are the rate limits for the Careem POS API?

Careem documents rate limiting under the 'Auth rate limiting' tag of its API reference and applies per-client throttling at the gateway. The OpenAPI specification does not publish numeric limits; if you receive 429 responses, slow polling on /orders and back off on bulk catalog updates. Refer to the official Careem POS docs for the current numbers.

How do I receive new orders — webhook or polling?

The OpenAPI surface itself exposes order retrieval through GET /orders and GET /orders/{order_id}, suitable for polling. The Careem documentation also references catalog and order webhook events under the 'Order API webhook events' and 'Catalog API webhook events' tags; configure those out-of-band with Careem to receive push notifications instead of polling.

How do I accept an order through Jentic?

Run `pip install jentic`, then use Jentic's search to find the order-state operation with the query "update careem order state", load the schema, and execute with `{"order_id": "ORD-9001", "state": "accepted"}`. Jentic calls PUT /orders/{order_id} with a fresh OAuth token from the vault and returns Careem's confirmation.

Can I tag orders with my own POS reference?

Yes. PATCH /orders/{order_id}/tags accepts arbitrary metadata you can use to attach a local POS ticket number, kitchen station ID, or operator initials. This is the recommended way to keep Careem orders linked to your own systems for later reporting.