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

# Making your first request

> Make your first CRM API request to list contacts from a connected CRM system

This guide walks you through making your first API request to retrieve data from a linked account.

## Prerequisites

1. [**API Key created in StackOne Dashboard**](/guides/api-keys) and copied to a secure location

2. [**Basic Authentication Setup**](/basic-authentication-with-stackone-api) - Learn how to properly authenticate with StackOne API using your API key

3. Required provider integration enabled

4. Account linked successfully

5. (Optional) Use an [SDK or Postman](/guides/stackone-api-sdks)

## Getting Account ID

<Note>
  **Authentication**: When using `curl -u "$API_KEY:"`, encoding is handled automatically. When setting the `Authorization` header manually, you must base64 encode your API key first. See the [Basic Authentication Guide](/basic-authentication-with-stackone-api) for details.
</Note>

1. List your linked accounts to find the account ID:

```bash theme={null}
curl --request GET \
     --url https://api.stackone.com/accounts \
     --header 'accept: application/json' \
     --header 'authorization: Basic {base64_encoded_api_key}'
```

2. From the response, copy the `id` value for your desired provider account.

<Tip>
  Filter by provider using the `providers` query parameter:

  ```bash theme={null}
  curl --request GET \
       --url 'https://api.stackone.com/accounts?providers={provider_name}' \
       --header 'accept: application/json' \
       --header 'authorization: Basic {base64_encoded_api_key}'
  ```
</Tip>

## Making Your First Request

Now you're ready to make your first CRM API call. Let's list contacts from the connected CRM system:

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl --request GET \
      --url 'https://api.stackone.com/unified/crm/contacts' \
      --header 'accept: application/json' \
      --header 'authorization: Basic {base64_encoded_api_key}' \
      --header 'x-account-id: {account_id}'
    ```
  </Tab>

  <Tab title="TypeScript">
    ```typescript theme={null}
    import { StackOne } from "@stackone/stackone-client-ts";

    const client = new StackOne({ apiKey: "YOUR_API_KEY" });

    const response = await client.crm.listContacts({
      xAccountId: "your-account-id"
    });

    console.log(response.contacts);
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    from stackone_client import StackOne

    client = StackOne(api_key="YOUR_API_KEY")

    response = client.crm.list_contacts(
        x_account_id="your-account-id"
    )

    print(response.contacts)
    ```
  </Tab>
</Tabs>

### Example Response

```json theme={null}
{
  "data": [
    {
      "id": "contact_123",
      "remote_id": "abc123",
      "first_name": "Sarah",
      "last_name": "Mitchell",
      "emails": [
        {
          "type": "work",
          "value": "sarah.mitchell@company.com"
        }
      ],
      "phone_numbers": [
        {
          "type": "work",
          "value": "+1-555-0456"
        }
      ],
      "company_name": "Acme Corp",
      "created_at": "2024-01-10T08:00:00Z"
    }
  ]
}
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Get Contact" icon="user" href="/crm/api-reference/contacts/get-contact">
    Retrieve details for a specific contact
  </Card>

  <Card title="List Accounts" icon="building" href="/crm/api-reference/accounts/list-accounts">
    Get company accounts from the CRM
  </Card>

  <Card title="Pagination" icon="arrow-right" href="/crm/common-guide/pagination">
    Handle large result sets efficiently
  </Card>

  <Card title="Get All Lists" icon="list" href="/crm/api-reference/lists/get-all-lists">
    View contact lists and segments
  </Card>
</CardGroup>

## References

* [Basic Authentication with API Keys](/basic-authentication-with-stackone-api)
* [List Accounts](/platform/api-reference/accounts/list-accounts)
* [Libraries & SDKs](/guides/stackone-api-sdks)
* [Connector Profiles](https://app.stackone.com/connector_profiles)