Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Just Eat Restaurant Claims API

The Restaurant Claims API from Just Eat — 4 operation(s) for restaurant claims.

Just Eat Restaurant Claims API is one of 24 APIs that Just Eat publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Restaurant Claims. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 4 operations across 4 paths, and defines 9 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against 3 base URLs: https://uk.api.just-eat.io, https://i18n.api.just-eat.io, https://aus.api.just-eat.io.

4 operations 4 paths 9 schemas 2 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://uk.api.just-eat.io
Authentication
HTTP Bearer, API Key, HTTP Basic, OpenID Connect, HTTP Bearer
Resource Areas
1

Authentication & Security 5

Just Eat Restaurant Claims API declares 5 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (Bearer). An API key is passed in the header as Authorization (api_key). It accepts HTTP basic authentication (basic_auth). It supports OpenID Connect (justeat_adfs) discovered at https://adfs.just-eat.com/adfs/.well-known/openid-configuration. It accepts HTTP bearer tokens (JWT token with payload `RestaurantId` and Role `[RestaurantRead | VerifyEmail | RestaurantWrite | FullAccess | DocumentRead]`) (restaurantsignup_jwt).

  • Bearer — Bearer token authentication using a JSON Web Token (JWT).
  • api_key — APIs for delivery partners require an API key that will have been issued to you.
  • basic_auth — A few services allow the use of basic authentication when a partner doesn't support OAuth based authentication.
  • justeat_adfs — ADFS authentication provider for internal Just Eat tools.
  • restaurantsignup_jwt — Bearer token authentication using a JSON Web Token (JWT), used by the restaurant sign up system

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 2 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Restaurant Claims 4
GET
/restaurants/{tenant}/{restaurantId}/customerclaims
Get claims
7 params → 200400401403500
GET
/restaurants/{tenant}/{restaurantId}/customerclaims/{id}
Get order claim
4 params → 200401403404500
POST
/restaurants/{tenant}/{restaurantId}/customerclaims/{id}/restaurantresponse
Submit a restaurant response for the claim
4 params body → 201400401403404409422500
PUT
/restaurants/{tenant}/{restaurantId}/customerclaims/{id}/restaurantresponse/justification
Add reason and comments to the response
4 params body → 204400401403404409500

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are OrderClaim (12 properties), Item (7 properties), ClaimResolution (4 properties), OrderClaimRestaurantResponse (3 properties). Each schema is shown below with its type and property counts.

ClaimResolution
object
Representation of the decision made about a claim
4 properties
OrderClaim
object
Claim information
12 properties
OrderClaimRestaurantResponse
object
Restaurant response for the claim
3 properties
Item
object
Information about an item in the claim
7 properties
500ErrorSchema
object
A HTTP 500 error response
1 property
4XXErrorSchema
object
A HTTP 4xx error response
1 property
Justification
object
The reason of the claim rejection and optional comments from the restaurant
2 properties
ItemDecision
object
Decision on the item
2 properties
ClaimsResponse
object
Response containing claims for a restaurant which match the given filter
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

just-eat-restaurant-claims-api-openapi.yml Raw ↑

Other APIs Just Eat publishes across the network.

Just Eat Attempted Delivery API API
Just Eat Attempted Delivery Webhooks API
Just Eat Checkout API
Just Eat Consumer Queries Webhooks API
Just Eat ConsumerQueries API
Just Eat Consumers API
Just Eat Delivery Pools API API
Just Eat DeliveryFee API
Just Eat Order Acceptance API API
Just Eat Order Acceptance Webhooks API
Just Eat Order API API
Just Eat Order Delivery API API