> ## Documentation Index
> Fetch the complete documentation index at: https://doc.convo.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /business/{business_id} — Retrieve Business Profile

> GET /business/{business_id} — Retrieve your Convo business account details. Returns display name, email, company, timezone, and linked project IDs.

Use this endpoint to retrieve details of your Convo business account, including the owner's contact information, billing currency, timezone, and the list of project IDs that belong to the business.

## Endpoint

```text theme={null}
GET https://connect.api-wa.co/project-apis/v1/business/{business_id}
```

***

## Path Parameters

<ParamField path="business_id" type="string" required>
  The unique ID of your business. You can find this in your Convo dashboard under **Settings → Business Profile**.
</ParamField>

***

## Request Example

```bash theme={null}
curl https://connect.api-wa.co/project-apis/v1/business/61f0624bcf0a58553378ceb4 \
  -H "X-API-WA-Project-API-Pwd: YOUR_API_PASSWORD"
```

***

## Response (200 OK)

<ResponseField name="id" type="string">
  The unique identifier of the business. Identical to `business_id`.
</ResponseField>

<ResponseField name="active" type="boolean">
  Indicates whether the business owner has logged in recently. `true` means the account is active.
</ResponseField>

<ResponseField name="display_name" type="string">
  The display name of the business owner as shown in the Convo dashboard.
</ResponseField>

<ResponseField name="project_ids" type="array of strings">
  A list of project IDs associated with this business account. Each project corresponds to a WhatsApp Business number.
</ResponseField>

<ResponseField name="user_name" type="string">
  The login username (typically an email address) of the business owner.
</ResponseField>

<ResponseField name="business_id" type="string">
  The unique business identifier. Same value as `id`.
</ResponseField>

<ResponseField name="email" type="string">
  The email address of the business owner on record with Convo.
</ResponseField>

<ResponseField name="created_at" type="integer">
  Unix timestamp in **milliseconds** representing when the business account was created.
</ResponseField>

<ResponseField name="updated_at" type="integer">
  Unix timestamp in **milliseconds** representing the last time the business record was updated.
</ResponseField>

<ResponseField name="company" type="string">
  The registered company or business name.
</ResponseField>

<ResponseField name="contact" type="string">
  The primary phone number of the business owner, including country code (e.g. `918116856154`).
</ResponseField>

<ResponseField name="currency" type="string">
  The billing currency for this business account. Either `INR` or `USD`.
</ResponseField>

<ResponseField name="timezone" type="string">
  The timezone configured for this business (e.g. `Asia/Calcutta`). Affects campaign scheduling and reporting.
</ResponseField>

<ResponseField name="type" type="string">
  The role of the authenticated user relative to this business. One of `owner`, `manager`, or `agent`.
</ResponseField>

### Response Example

```json theme={null}
{
  "id": "61f0624bcf0a58553378ceb4",
  "active": true,
  "display_name": "Shop XY",
  "project_ids": ["61f06252cf0a58553378ceb5"],
  "user_name": "owner@example.com",
  "business_id": "61f0624bcf0a58553378ceb4",
  "email": "owner@example.com",
  "created_at": 1643143755321,
  "updated_at": 1643143755321,
  "company": "Shop XY",
  "contact": "918116856154",
  "currency": "INR",
  "timezone": "Asia/Calcutta",
  "type": "owner"
}
```

***

## Error Responses

<ResponseField name="400 Bad Request" type="object">
  Returned when the `business_id` format is invalid or cannot be parsed.

  ```json theme={null}
  {
    "name": "ERR400",
    "message": "Invalid Business ID!"
  }
  ```
</ResponseField>

<ResponseField name="404 Not Found" type="object">
  Returned when no business account matching the provided `business_id` exists.

  ```json theme={null}
  {
    "name": "ERR404",
    "message": "Business doesn't exist!"
  }
  ```
</ResponseField>

<ResponseField name="500 Internal Server Error" type="object">
  Returned when an unexpected error occurs on Convo's servers. Retry the request with exponential back-off.

  ```json theme={null}
  {
    "name": "ERR500",
    "message": "Internal server error."
  }
  ```
</ResponseField>