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

# Fetch endpoint

> Example requests for the Fetch Profile and Fetch Company endpoints.

These examples target the [Fetch Profile](/docs/endpoints/v3/fetch-profile) and [Fetch Company](/docs/endpoints/v3/fetch-company) endpoints.

## Identifier types

You can fetch a profile using any of the following identifiers, or a combination of them:

* **`ids`** — Profile IDs previously returned by the Search endpoint
* **`linkedin_names`** — LinkedIn usernames (public profile URL slugs)
* **`linkedin_ids`** — LinkedIn numeric member IDs
* **`linkedin_entity_ids`** — LinkedIn alphanumeric entity IDs

Combining identifiers is supported and returns a unified list of results.

```bash theme={null}
curl --location 'https://bee.theswarm.com/v3/profiles/fetch' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: $API_KEY' \
  --data '{
    "ids": [
      "569a18b6-6a04-4728-9034-ad6ae0537f09",
      "41dfd52f-e9da-4381-80a2-b514cf75c134"
    ],
    "linkedin_names": [
      "michal-bil"
    ],
    "linkedin_ids": [
      "7125957"
    ],
    "linkedin_entity_ids": [
      "ACoAAABsu8UBWktgug9TYQMXLNK3ypLlA0tWUuY"
    ]
  }'
```

## Selecting fields

By default, only basic profile data is returned. Use the `fields` array to request additional data — pass `profile_info` for the full record, plus `tags` or `lists` as needed.

### Fetch full profile data

```bash theme={null}
curl --location 'https://bee.theswarm.com/v3/profiles/fetch' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: $API_KEY' \
  --data '{
    "ids": ["569a18b6-6a04-4728-9034-ad6ae0537f09"],
    "fields": ["profile_info"]
  }'
```

### Fetch with tags and lists

```bash theme={null}
curl --location 'https://bee.theswarm.com/v3/profiles/fetch' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: $API_KEY' \
  --data '{
    "ids": ["569a18b6-6a04-4728-9034-ad6ae0537f09"],
    "fields": ["profile_info", "tags", "lists"]
  }'
```

## Bulk fetch

Fetch up to **1000 profiles per call**. Each returned profile counts as 1 credit — see [Credits & Usage](/docs/api-reference/credits-usage).

```bash theme={null}
curl --location 'https://bee.theswarm.com/v3/profiles/fetch' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: $API_KEY' \
  --data '{
    "ids": [
      "569a18b6-6a04-4728-9034-ad6ae0537f09",
      "b8d4ba05-5158-4d80-a0a7-c8e650f7c95c",
      "41dfd52f-e9da-4381-80a2-b514cf75c134"
    ],
    "fields": ["profile_info"]
  }'
```

## Fetching companies

The Company Fetch endpoint follows the same pattern with `company_info` as the default field.

```bash theme={null}
curl --location 'https://bee.theswarm.com/v3/companies/fetch' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: $API_KEY' \
  --data '{
    "ids": ["09d9c510-c9f6-4c6e-9e62-fe5fedbeda87"],
    "fields": ["company_info", "tags"]
  }'
```