# Contracting API


Use the Contracting API to invite a new partner on Booking.com, check whether a partner has signed the contract, resend invitation mail and retrieve the legal entity of the partner.
## Authentication
The Contracting API supports token-based authentication. Each request must have an `Authorization` header containing a JWT token. Manage your machine accounts in the [Connectivity Portal](https://developers.booking.com). See also the [Authentication page](/connectivity/docs/authentication) of the documentation.
## Message formats
The Contracting API accepts and returns JSON.
## Documentation
Read the [Contracting API documentation](/connectivity/docs/contracting-api/understanding-the-contracting-api) for more details about working with this API.


Version: 1.0.0

## Servers

Test using live endpoint
```
https://supply-xml.booking.com/contracts-api
```

## Download OpenAPI description

[Contracting API](https://developers.booking.com/_bundle/connectivity/docs/openapispecs/contracting-api/contracting-api-specificaion.yaml)

## Manage contracts

Create, update or resend contract details.

### Create a contract and legal entity ID

 - [POST /partners/invite](https://developers.booking.com/connectivity/docs/openapispecs/contracting-api/contracting-api-specificaion/manage-contracts/postpartnersinvite.md): Use this endpoint to create a partner card for a new partner and invite them to sign a contract with Booking.com

### Update an existing contract

 - [POST /partners/addendum](https://developers.booking.com/connectivity/docs/openapispecs/contracting-api/contracting-api-specificaion/manage-contracts/postpartnersaddendum.md): Use this endpoint to send addendum to the partner to add more countries where properties can be listed, only if partner has already a signed contract with Booking.com.

### Resend contract details

 - [POST /partners/resend-invite](https://developers.booking.com/connectivity/docs/openapispecs/contracting-api/contracting-api-specificaion/manage-contracts/postpartnersresendinvite.md): Use this endpoint to resend the invitation email to the partner's registered contract email address.

### Resend updated contract

 - [POST /partners/resend-addendum](https://developers.booking.com/connectivity/docs/openapispecs/contracting-api/contracting-api-specificaion/manage-contracts/postpartnersresendaddendum.md): Use this endpoint to resend addendum to the partner to add more countries where properties can be listed, only if partner has already a signed contract with Booking.com.

## Check legal details

Check legal details of Partner using email or entity ID.

### Check Partner legal details with email

 - [POST /partners/legal-details](https://developers.booking.com/connectivity/docs/openapispecs/contracting-api/contracting-api-specificaion/check-legal-details/postpartnerslegaldetails.md): Use this endpoint to check the details of Partner within Booking.com for the mentioned partner email ID

### Check Partner legal details with entity ID

 - [GET /partners/legal-details/legal-entity/{id}](https://developers.booking.com/connectivity/docs/openapispecs/contracting-api/contracting-api-specificaion/check-legal-details/getpartnerslegaldetailslegalentitybyid.md): Use this endpoint to check the details of Partner within Booking.com for the given legal entity ID.

## Request access

Request access to existing partner.

### Request access to existing partner

 - [POST /partners/request_access](https://developers.booking.com/connectivity/docs/openapispecs/contracting-api/contracting-api-specificaion/request-access/postpartnersrequestaccess.md): Use this endpoint to request access to an existing partner of Booking.com