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

# Get Account Opening Request By ID

> Retrieve a single account opening request using its unique identifier. Returns all details of the request including company information, contacts, addresses, status, and history.

## Path Parameters

<ParamField path="id" type="string" required>
  Unique identifier of the account opening request
</ParamField>

## Response Body

<ResponseField name="id" type="string">
  Unique identifier of the account opening request
</ResponseField>

<ResponseField name="company" type="object">
  Company information

  <Expandable title="Company Details">
    <ResponseField name="legal_name" type="string">
      Company’s registered legal name
    </ResponseField>

    <ResponseField name="trade_name" type="string">
      Company’s trade name or business name
    </ResponseField>

    <ResponseField name="tax_id" type="string">
      Company’s tax identification number (CNPJ), numbers only
    </ResponseField>

    <ResponseField name="contacts" type="array">
      List of contact persons associated with the company. Each object represents a contact.

      <Expandable title="Contact">
        <ResponseField name="name" type="string">
          Full name of the contact person
        </ResponseField>

        <ResponseField name="email" type="string">
          Email address of the contact person
        </ResponseField>

        <ResponseField name="phone" type="string">
          Phone number including country and area code
        </ResponseField>

        <ResponseField name="tax_id" type="string">
          Contact’s individual tax ID (CPF), numbers only
        </ResponseField>

        <ResponseField name="role" type="string">
          Role within the company

          Allowed values: `administrator`, `legal_representative`, `financial`, `commercial`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="address" type="array">
      List of addresses related to the company

      <Expandable title="Address">
        <ResponseField name="city" type="string">
          City name
        </ResponseField>

        <ResponseField name="state" type="string">
          State abbreviation (UF)
        </ResponseField>

        <ResponseField name="country" type="string">
          ISO 3166-1 alpha-2 country code
        </ResponseField>

        <ResponseField name="zip_code" type="string">
          Postal code (CEP), numbers only
        </ResponseField>

        <ResponseField name="street" type="string">
          Street or public place name
        </ResponseField>

        <ResponseField name="number" type="string">
          Address number
        </ResponseField>

        <ResponseField name="complement" type="string">
          Address complement, if any
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="status" type="string">
  Current status of the account opening request

  Values: `pending`, `due_diligence_review`, `active`, `inactive`, `canceled`, `closed`
</ResponseField>

<ResponseField name="status_history" type="array">
  List of all previous status changes for the request

  <Expandable title="Status History">
    <ResponseField name="status" type="string">
      Status value at that point in history
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Date and time when the status was changed
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="account_id" type="integer">
  Identifier of the account linked after approval
</ResponseField>

<ResponseField name="created_at" type="string">
  Date and time when the account opening request was created
</ResponseField>

<ResponseField name="updated_at" type="string">
  Date and time when the request was last updated
</ResponseField>

## Request Example

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://api.sandbox.wepayout.com.br/v2/register/companies/{id} \
    --header 'Accept: application/json' \
    --header 'Authorization: Bearer YOUR_TOKEN'
  ```

  ```javascript JavaScript theme={null}
  const id = '550e8400-e29b-41d4-a716-446655440000';
  const response = await fetch(
    `https://api.wepayments.com/v2/register/companies/${id}`,
    {
      headers: {
        'Accept': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
      }
    }
  );

  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  id = '550e8400-e29b-41d4-a716-446655440000'
  url = f'https://api.wepayments.com/v2/register/companies/{id}'
  headers = {
      'Accept': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN'
  }

  response = requests.get(url, headers=headers)
  data = response.json()

  print(data)
  ```
</CodeGroup>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "company": {
      "legal_name": "Acme Tech LTDA",
      "trade_name": "Acme Tech",
      "tax_id": "11222333000181",
      "contacts": [
        {
          "name": "João Silva",
          "email": "joao@acme.com",
          "phone": "+5511999999999",
          "tax_id": "12345678901",
          "role": "administrator"
        },
        {
          "name": "Maria Silva",
          "email": "maria.silva@acme.com",
          "phone": "+5511999999999",
          "tax_id": "12345678000",
          "role": "legal_representative"
        }
      ],
      "address": [
        {
          "city": "São Paulo",
          "state": "SP",
          "country": "Brasil",
          "zip_code": "01234-567",
          "street": "Rua das Flores",
          "number": "123",
          "complement": "Sala 1"
        }
      ]
    },
    "status": "active",
    "status_history": [
      {
        "status": "pending",
        "created_at": "2024-01-01T10:00:00.000000Z"
      },
      {
        "status": "due_diligence_review",
        "created_at": "2024-01-02T10:00:00.000000Z"
      },
      {
        "status": "active",
        "created_at": "2024-01-03T10:00:00.000000Z"
      }
    ],
    "account_id": 999900,
    "created_at": "2024-01-01T10:00:00.000000Z",
    "updated_at": "2024-01-03T10:00:00.000000Z"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": "Account opening request not found"
  }
  ```
</ResponseExample>