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

# Quickstart

> Make your first Smartcomply API call in under 5 minutes.

## Prerequisites

Before you start, make sure you have:

* A Smartcomply account — [sign up here](https://adhere-app.smartcomply.com/signup)
* Completed your business KYC on the Adhere dashboard
* Generated a secret key under **Settings → API Keys**

## Make Your First Request

The example below verifies a Nigerian BVN. Replace `YOUR_SECRET_KEY` with your actual key.

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/bvn/" \
    -H "x-access-token: YOUR_SECRET_KEY" \
    -H "Content-Type: application/json" \
    -d '{"bvn": "22000000001"}'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/bvn/",
    {
      method: "POST",
      headers: {
        "x-access-token": "YOUR_SECRET_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ bvn: "22000000001" }),
    }
  );
  const data = await response.json();
  console.log(data);
  ```

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

  response = requests.post(
      "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/bvn/",
      headers={
          "x-access-token": "YOUR_SECRET_KEY",
          "Content-Type": "application/json",
      },
      json={"bvn": "22000000001"},
  )
  print(response.json())
  ```
</CodeGroup>

## Successful Response

```json theme={null}
{
  "status": "success",
  "data": {
    "lastName": "OMOLE",
    "firstName": "ABRAHAM",
    "middleName": "ISAAC",
    "dateOfBirth": "1909-09-19",
    "phoneNumber1": "09011001100"
  },
  "message": "Bank Verification Number details retrieved successfully"
}
```

If you receive a `401`, check that your `x-access-token` header is set correctly. For a full list of error responses, see [Error Codes](/error_codes).

## Next Steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Learn how to secure and manage your API keys.
  </Card>

  <Card title="KYC Endpoints" icon="id-card" href="/v3/kyc/nigeria/BVN">
    Explore all identity verification endpoints.
  </Card>

  <Card title="Error Codes" icon="triangle-exclamation" href="/error_codes">
    Understand all possible error responses.
  </Card>

  <Card title="Webhooks" icon="bell" href="/webhooks">
    Set up real-time event notifications.
  </Card>
</CardGroup>