---
title: "Check Partner legal details with entity ID"
method: GET
path: "/partners/legal-details/legal-entity/{id}"
tags: ["Check legal details"]
---

# Check Partner legal details with entity ID

`GET /partners/legal-details/legal-entity/{id}`

## Request

- Base URL: `https://supply-xml.booking.com/contracts-api`
- URL: `https://supply-xml.booking.com/contracts-api/partners/legal-details/legal-entity/{id}`
- Auth: HTTP bearer

Use this endpoint to check the details of Partner within Booking.com for the given legal entity ID.

## Path parameters

- `id` integer, required

## Response `200`

OK

- object
  - `data` PartnerDetailsObject, required
    - `city` string: City name of the partner company.
    - `company_name` string: Commercial name of the company. Use the partner name if a commercial name is not available.
    - `contract_countries` string[]: A list of all the country names for which contract has been signed.
    - `contract_signed` integer, required: Indicates whether the partner contract is signed. Returns 1 if signed, 0 if unsigned.
    - `country` string: Country name of the partner company.
    - `legal_contact_email` string: Contact email of the partner. This is treated as the unique identifier for the partner.
    - `legal_contact_name` string: Contact name of the person authorized to sign.
    - `legal_contact_phone_number` string: Contact phone number of the partner.
    - `legal_entity_id` integer, required: The legal entity ID of the new partner invited.
    - `total_number_of_properties` integer: Total number of properties (at different addresses) listed under the legal entity.
  - `errors` object[]
    - `code` string, required: Alphanumeric identifier for warning/error.
    - `details` object, required: Additional details of warning/error.
    - `message` string, required: English-language description of warning/error.
  - `meta` object, required
    - `ruid` string, required: Response Unique Identifier. Refer to this when talking to Booking.com Connectivity Support.
  - `warnings` object[]
    - `code` string, required: Alphanumeric identifier for warning/error.
    - `details` object, required: Additional details of warning/error.
    - `message` string, required: English-language description of warning/error.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

## Changes

- **2026-10-07** `ac30284c1913`: 8 breaking, 1 info
  - the response property `data/city` became optional for the status `200`
  - the response property `data/company_name` became optional for the status `200`
  - the response property `data/contract_countries` became optional for the status `200`
  - the response property `data/country` became optional for the status `200`
  - …5 more

[Operation history](https://skmtc.dev/booking/apis/contracting-api/changes/partners/legal-details/legal-entity/:id/get.md)

---

[API](https://skmtc.dev/booking/apis/contracting-api.md) - [All operations](https://skmtc.dev/booking/apis/contracting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/booking/apis/contracting-api/revisions/ac30284c1913?raw)