---
title: "[Bulk] Entity Locations"
method: POST
path: "/entities/locations"
tags: ["General"]
---

# \[Bulk\] Entity Locations

`POST /entities/locations`

## Request

- Base URL: `https://api.pitchbook.com`
- URL: `https://api.pitchbook.com/entities/locations`
- Auth: API key in header `Authorization`

Retrieves data about locations of HQ and alternate offices of the specific entity. This bulk call allows you to send multiple pbIds within a single API call.

## Request body

- BulkRequestDto
  - `items` RequestItemDto[]
    - `id` string

## Response `200`

OK

- BulkResultDtoEntityLocationsDto
  - `stats` BulkStatsDto
    - `total` integer
    - `matched` integer
    - `noData` integer
    - `unmatched` integer
    - `duplicates` integer
  - `matched` EntityLocationsDto[]
    - `entityId` string
    - `hqOffice` EntityOfficeDto
      - `location` string
      - `addressLine1` string
      - `addressLine2` string
      - `city` string
      - `stateProvince` string
      - `postCode` string
      - `country` string
      - `phone` string
      - `fax` string
      - `email` string
      - `globalRegion` string
      - `globalSubRegion` string
    - `alternateOffices` EntityOfficeDto[]
      - `location` string
      - `addressLine1` string
      - `addressLine2` string
      - `city` string
      - `stateProvince` string
      - `postCode` string
      - `country` string
      - `phone` string
      - `fax` string
      - `email` string
      - `globalRegion` string
      - `globalSubRegion` string
    - `alternateOfficesCount` integer
  - `noData` NoDataItemDto[]
    - `id` string
  - `unmatched` FailedItemDto[]
    - `id` string
    - `reason` '400 BAD_REQUEST' | '401 UNAUTHORIZED' | '402 PAYMENT_REQUIRED' | '403 FORBIDDEN' | '404 NOT_FOUND' | '405 METHOD_NOT_ALLOWED' | '415 UNSUPPORTED_MEDIA_TYPE' | '429 TOO_MANY_REQUESTS' | '500 INTERNAL_SERVER_ERROR' | '503 SERVICE_UNAVAILABLE'
    - `message` string
  - `duplicates` DuplicatedItemDto[]
    - `id` string
    - `occurrence` integer

## Other responses

- `400`: Bad Request
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable
- `504`: Gateway Timeout

---

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