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

# Get Enrichment Credits

> Returns the current enrichment credit balance for the team that owns the API key. Each completed email enrichment costs 1 credit.

Returns the current enrichment credit balance for the team that owns the API key.

Each **completed** email enrichment costs **1 credit**. Use this endpoint to check available credits before kicking off enrichment requests — a request with a zero balance is rejected with `402 Payment Required`.

### Response (200)

```json theme={null}
{
  "balance": 250
}
```

| Field     | Type    | Description                                          |
| --------- | ------- | ---------------------------------------------------- |
| `balance` | integer | Number of enrichment credits remaining for the team. |


## OpenAPI

````yaml GET /v1/api/enrichment/credits
openapi: 3.0.1
info:
  title: Salesfinity API
  description: API documentation for Salesfinity platform
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://client-api.salesfinity.co
security:
  - ApiKeyAuth: []
paths:
  /v1/api/enrichment/credits:
    get:
      tags:
        - Enrichment
      summary: Get enrichment credit balance
      description: >-
        Returns the current enrichment credit balance for the team that owns the
        API key. Each completed email enrichment costs 1 credit.
      operationId: get-enrichment-credits
      responses:
        '200':
          description: Current credit balance.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreditBalanceDTO'
components:
  schemas:
    CreditBalanceDTO:
      type: object
      required:
        - balance
      properties:
        balance:
          type: integer
          description: Number of enrichment credits remaining for the team.
          example: 250
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````