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

# Obtener saldo de la empresa

> Este endpoint obtiene el saldo actual de la cuenta de una empresa

### Parámetros

<ParamField path="companyId" type="string" required>
  El identificador único de la empresa
</ParamField>

### Respuesta

<ResponseField name="success" type="boolean">
  Indica si la operación fue exitosa
</ResponseField>

<ResponseField name="companyId" type="string">
  El identificador único de la empresa
</ResponseField>

<ResponseField name="balance" type="number">
  Saldo disponible actual
</ResponseField>

<ResponseField name="currency" type="string">
  Código de moneda (por ejemplo, "USD")
</ResponseField>

<ResponseField name="pendingBalance" type="number">
  Saldo pendiente de transacciones sin liquidar
</ResponseField>

<ResponseField name="updatedAt" type="string">
  Fecha y hora (ISO 8601) de la última actualización del saldo
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request GET 'https://stablecoin-api.sandbox.getmeru.com/api/v1/cards-program/companies/8f3e1a2b-4c5d-6e7f-8a9b-0c1d2e3f4a5b/balance' \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>'
  ```

  ```js Javascript theme={null}
  const response = await fetch('https://stablecoin-api.sandbox.getmeru.com/api/v1/cards-program/companies/8f3e1a2b-4c5d-6e7f-8a9b-0c1d2e3f4a5b/balance', {
    method: 'GET',
    headers: {
      'Content-Type': 'application/json',
      'api-key': '<api-key>'
    }
  });

  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "companyId": "8f3e1a2b-4c5d-6e7f-8a9b-0c1d2e3f4a5b",
    "balance": 50000.00,
    "currency": "USD",
    "pendingBalance": 1250.50,
    "updatedAt": "2024-01-17T15:45:00Z"
  }
  ```
</ResponseExample>

### Respuestas de error

<ResponseExample>
  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized. Please check your authentication credentials."
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": "Company not found."
  }
  ```
</ResponseExample>