---
title: "Business identifier"
method: GET
path: "/v2/book/{book_uuid}/business"
tags: ["Business history"]
---

# Business identifier

`GET /v2/book/{book_uuid}/business`

## Request

- Base URL: `https://api.ocrolus.com`
- URL: `https://api.ocrolus.com/v2/book/{book_uuid}/business`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.ocrolus.com/oauth/token`

This API retrieves the business associated with a given `book_uuid`. It returns the business ID and display name, which can be used with business-level endpoints to access aggregated data across multiple <<glossary:Book>>s. 
A single business can have multiple Books. All books associated with the same business within your organization return the same business ID.

## Path parameters

- `book_uuid` string, uuid, required

## Response `200`

Success

- object
  - `id` string: Universally Unique Identifier (UUID) of the business entity. This is a stable identifier that is used with all business endpoints.
  - `name` string: Display name of the business. The name is determined in the following order: user-defined display name, org-specific name, then global entity name.

## Other responses

- `400`: Invalid Auth/Book UUID format
- `403`: Book not associated with requesting organization
- `404`: Business Identity Not Associated With Book
- `500`: Internal server error

---

[API](https://skmtc.dev/ocrolus/apis/business-history.md) - [All operations](https://skmtc.dev/ocrolus/apis/business-history/llms.txt) - [OpenAPI document](https://skmtc.dev/ocrolus/apis/business-history/revisions/8f419cb52efa?raw)