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

# Amplemarket: Get Lead Lists ID

> Get an Amplemarket lead list and its leads by list ID. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Get an Amplemarket lead list and its leads by list ID.

> [!NOTE]
>
> Tool ID: `amplemarket_get_lead_lists_id`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'amplemarket_get_lead_lists_id',
  {
    "id": "id_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute amplemarket_get_lead_lists_id --input '{
  "id": "id_123"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "id": "123e4567-e89b-42d3-a456-426614174000",
    "object": "lead_list",
    "name": "Example",
    "status": "queued",
    "url": "https://example.com",
    "shared": true,
    "visible": true,
    "owner": "jane.doe@example.com",
    "type": "linkedin",
    "leads": [
      {
        "id": "123e4567-e89b-42d3-a456-426614174000",
        "object": "lead_list_entry",
        "email": "jane.doe@example.com",
        "person_id": "123e4567-e89b-42d3-a456-426614174000",
        "linkedin_url": "https://www.linkedin.com/in/jane-doe",
        "linkedin": "https://www.linkedin.com/in/jane-doe",
        "first_name": "Jane",
        "last_name": "Doe",
        "company_name": "Example Corp",
        "company_domain": "example.com",
        "industry": "example",
        "title": "VP of Engineering",
        "email_validation_result": {
          "object": "email_validation_result",
          "email": "jane.doe@example.com",
          "result": "deliverable"
        },
        "data": {}
      }
    ],
    "_links": {
      "self": {
        "href": "example"
      }
    }
  }
}
```

Use `deepline describe amplemarket_get_lead_lists_id --json` for the latest machine-readable contract.

## Input reference

Retrieve Lead List

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | Yes | — | Lead List id |
| `payload.page` | `object` | No | — | Page size. Accepts an integer or a numeric string. Amplemarket types this field inconsistently across operations. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieve Lead List",
    "properties": {
      "id": {
        "type": "string",
        "description": "Lead List id"
      },
      "page": {
        "type": "object",
        "description": "Page size. Accepts an integer or a numeric string; Amplemarket types this field inconsistently across operations.",
        "properties": {
          "size": {
            "type": [
              "integer",
              "string"
            ],
            "description": "Page size. Accepts an integer or a numeric string; Amplemarket types this field inconsistently across operations."
          },
          "after": {
            "type": "string",
            "description": "Page after"
          },
          "before": {
            "type": "string",
            "description": "Page before"
          }
        },
        "required": [],
        "additionalProperties": false
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.id` | `string` | Yes | — | Format: `uuid`. |
| `result.data.object` | `"lead_list"` | Yes | — | Allowed: `lead_list`. |
| `result.data.name` | `string` | Yes | — | — |
| `result.data.status` | `"queued" \| "processing" \| "completed"` | Yes | — | Allowed: `queued`, `processing`, `completed`. |
| `result.data.url` | `string` | Yes | — | — |
| `result.data.shared` | `boolean` | Yes | — | — |
| `result.data.visible` | `boolean` | Yes | — | — |
| `result.data.owner` | `string` | Yes | — | Format: `email`. |
| `result.data.type` | `"linkedin" \| "email" \| "title_and_company" \| "name_and_company" \| "salesforce" \| "hubspot" \| "person" \| "adaptive"` | Yes | — | Allowed: `linkedin`, `email`, `title_and_company`, `name_and_company`, `salesforce`, `hubspot`, `person`, `adaptive`. |
| `result.data.created_at` | `string` | No | — | Format: `date_time`. |
| `result.data.updated_at` | `string` | No | — | Format: `date_time`. |
| `result.data.options` | `object` | No | — | — |
| `result.data.options.reveal_phone_numbers` | `boolean` | Yes | — | — |
| `result.data.options.validate_email` | `boolean` | Yes | — | — |
| `result.data.options.enrich` | `boolean` | Yes | — | — |
| `result.data.leads` | `array` | Yes | — | — |
| `result.data.leads[].id` | `string` | Yes | — | Format: `uuid`. |
| `result.data.leads[].object` | `"lead_list_entry"` | Yes | — | Allowed: `lead_list_entry`. |
| `result.data.leads[].email` | `string` | Yes | — | Format: `email`. |
| `result.data.leads[].person_id` | `string` | Yes | — | Format: `uuid`. |
| `result.data.leads[].linkedin_url` | `string` | Yes | — | — |
| `result.data.leads[].linkedin` | `string` | Yes | — | — |
| `result.data.leads[].first_name` | `string` | Yes | — | — |
| `result.data.leads[].last_name` | `string` | Yes | — | — |
| `result.data.leads[].company_name` | `string` | Yes | — | — |
| `result.data.leads[].company_domain` | `string` | Yes | — | — |
| `result.data.leads[].industry` | `string` | Yes | — | — |
| `result.data.leads[].title` | `string` | Yes | — | — |
| `result.data.leads[].email_validation_result` | `object` | Yes | — | — |
| `result.data.leads[].email_validation_result.object` | `"email_validation_result"` | Yes | — | Allowed: `email_validation_result`. |
| `result.data.leads[].email_validation_result.email` | `string` | Yes | — | Format: `email`. |
| `result.data.leads[].email_validation_result.result` | `"deliverable" \| "risky" \| "undeliverable" \| "unknown"` | Yes | — | Allowed: `deliverable`, `risky`, `undeliverable`, `unknown`. |
| `result.data.leads[].data` | `record` | Yes | — | — |
| `result.data.leads[].phone_numbers` | `array` | No | — | — |
| `result.data.leads[].phone_numbers[].object` | `"phone_number"` | Yes | — | Allowed: `phone_number`. |
| `result.data.leads[].phone_numbers[].id` | `string` | Yes | — | Format: `uuid`. |
| `result.data.leads[].phone_numbers[].number` | `string` | Yes | — | — |
| `result.data.leads[].phone_numbers[].type` | `"mobile" \| "office" \| "phone" \| "landline" \| "voip" \| "direct"` | Yes | — | Allowed: `mobile`, `office`, `phone`, `landline`, `voip`, `direct`. |
| `result.data.leads[].phone_numbers[].source` | `"amplemarket" \| "crm" \| "user_uploaded" \| "uploaded_by_user"` | No | — | Origin of the phone number. Amplemarket returns uploaded\_by\_user for numbers supplied through post\_contacts. Allowed: `amplemarket`, `crm`, `user_uploaded`, `uploaded_by_user`. |
| `result.data.leads[].phone_numbers[].is_wrong_number` | `boolean` | Yes | — | — |
| `result.data.leads[].phone_numbers[].is_dnc_listed` | `boolean` | No | — | Present only when the account has phone number DNC list enabled |
| `result.data.leads[].phone_numbers[].kind` | `string` | No | — | Phone number kind. Amplemarket returns this alongside the documented type field. |
| `result.data.leads[].phone_numbers[].uploaded_id` | `string` | No | — | Identifier of the uploaded phone number record, present when a caller supplied the number. |
| `result.data._errors` | `array` | No | — | — |
| `result.data._errors[].code` | `string` | Yes | — | — |
| `result.data._errors[].title` | `string` | Yes | — | — |
| `result.data._errors[].detail` | `string` | Yes | — | — |
| `result.data._errors[].source` | `object` | No | — | — |
| `result.data._errors[].source.pointer` | `string` | No | — | — |

The table shows the first 50 fields. Expand the raw schema below for every field.

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "object": {
            "type": "string",
            "enum": [
              "lead_list"
            ]
          },
          "name": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "queued",
              "processing",
              "completed"
            ]
          },
          "url": {
            "type": "string"
          },
          "shared": {
            "type": "boolean"
          },
          "visible": {
            "type": "boolean"
          },
          "owner": {
            "type": "string",
            "format": "email"
          },
          "type": {
            "type": "string",
            "enum": [
              "linkedin",
              "email",
              "title_and_company",
              "name_and_company",
              "salesforce",
              "hubspot",
              "person",
              "adaptive"
            ]
          },
          "created_at": {
            "type": "string",
            "format": "date_time"
          },
          "updated_at": {
            "type": "string",
            "format": "date_time"
          },
          "options": {
            "type": "object",
            "properties": {
              "reveal_phone_numbers": {
                "type": "boolean"
              },
              "validate_email": {
                "type": "boolean"
              },
              "enrich": {
                "type": "boolean"
              }
            },
            "required": [
              "reveal_phone_numbers",
              "validate_email",
              "enrich"
            ],
            "additionalProperties": false
          },
          "leads": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "object": {
                  "type": "string",
                  "enum": [
                    "lead_list_entry"
                  ]
                },
                "email": {
                  "type": "string",
                  "format": "email"
                },
                "person_id": {
                  "type": "string",
                  "format": "uuid"
                },
                "linkedin_url": {
                  "type": "string"
                },
                "linkedin": {
                  "type": "string"
                },
                "first_name": {
                  "type": "string"
                },
                "last_name": {
                  "type": "string"
                },
                "company_name": {
                  "type": "string"
                },
                "company_domain": {
                  "type": "string"
                },
                "industry": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "email_validation_result": {
                  "type": "object",
                  "properties": {
                    "object": {
                      "type": "string",
                      "enum": [
                        "email_validation_result"
                      ]
                    },
                    "email": {
                      "type": "string",
                      "format": "email"
                    },
                    "result": {
                      "type": "string",
                      "enum": [
                        "deliverable",
                        "risky",
                        "undeliverable",
                        "unknown"
                      ]
                    }
                  },
                  "required": [
                    "object",
                    "email",
                    "result"
                  ],
                  "additionalProperties": false
                },
                "data": {
                  "type": "object",
                  "additionalProperties": true
                },
                "phone_numbers": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "object": {
                        "type": "string",
                        "enum": [
                          "phone_number"
                        ]
                      },
                      "id": {
                        "type": "string",
                        "format": "uuid"
                      },
                      "number": {
                        "type": "string"
                      },
                      "type": {
                        "type": "string",
                        "enum": [
                          "mobile",
                          "office",
                          "phone",
                          "landline",
                          "voip",
                          "direct"
                        ]
                      },
                      "source": {
                        "type": "string",
                        "description": "Origin of the phone number. Amplemarket returns uploaded_by_user for numbers supplied through post_contacts.",
                        "enum": [
                          "amplemarket",
                          "crm",
                          "user_uploaded",
                          "uploaded_by_user"
                        ]
                      },
                      "is_wrong_number": {
                        "type": "boolean"
                      },
                      "is_dnc_listed": {
                        "type": "boolean",
                        "description": "Present only when the account has phone number DNC list enabled"
                      },
                      "kind": {
                        "type": "string",
                        "description": "Phone number kind. Amplemarket returns this alongside the documented type field."
                      },
                      "uploaded_id": {
                        "type": "string",
                        "description": "Identifier of the uploaded phone number record, present when a caller supplied the number."
                      }
                    },
                    "required": [
                      "object",
                      "id",
                      "number",
                      "type",
                      "is_wrong_number"
                    ],
                    "additionalProperties": true
                  }
                }
              },
              "required": [
                "id",
                "object",
                "email",
                "person_id",
                "linkedin_url",
                "linkedin",
                "first_name",
                "last_name",
                "company_name",
                "company_domain",
                "industry",
                "title",
                "email_validation_result",
                "data"
              ],
              "additionalProperties": false
            }
          },
          "_errors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "detail": {
                  "type": "string"
                },
                "source": {
                  "type": "object",
                  "properties": {
                    "pointer": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "required": [
                "code",
                "title",
                "detail"
              ],
              "additionalProperties": false
            }
          },
          "_links": {
            "type": "object",
            "properties": {
              "self": {
                "type": "object",
                "properties": {
                  "href": {
                    "type": "string"
                  }
                },
                "required": [
                  "href"
                ],
                "additionalProperties": false
              },
              "prev": {
                "type": "object",
                "properties": {
                  "href": {
                    "type": "string"
                  }
                },
                "required": [
                  "href"
                ],
                "additionalProperties": false
              },
              "next": {
                "type": "object",
                "properties": {
                  "href": {
                    "type": "string"
                  }
                },
                "required": [
                  "href"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "self"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "id",
          "object",
          "name",
          "status",
          "url",
          "shared",
          "visible",
          "owner",
          "type",
          "leads",
          "_links"
        ],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Amplemarket provider guide](https://deepline.com/docs/providers/amplemarket/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.