Skip to main content
GET
/
v2
/
lists
/
{listId}
/
list-entries
/
{listEntryId}
Get a single List Entry on a List
curl --request GET \
  --url https://api.affinity.co/v2/lists/{listId}/list-entries/{listEntryId} \
  --header 'Authorization: Bearer <token>'
{
  "id": 1,
  "type": "company",
  "listId": 1,
  "entity": {
    "id": 1,
    "name": "Acme",
    "domain": "acme.co",
    "domains": [
      "acme.co"
    ],
    "isGlobal": true,
    "fields": [
      {
        "id": "affinity-data-description",
        "name": "Description",
        "type": "enriched",
        "enrichmentSource": "affinity-data",
        "value": {
          "type": "text",
          "data": "Acme is a mega-corporation that manufactures everything from anvils to earthquake pills."
        }
      },
      {
        "id": "affinity-data-industry",
        "name": "Industry",
        "type": "enriched",
        "enrichmentSource": "affinity-data",
        "value": {
          "type": "filterable-text-multi",
          "data": [
            "Aerospace",
            "Construction",
            "Consumer Goods"
          ]
        }
      },
      {
        "id": "affinity-data-investment-stage",
        "name": "Investment Stage",
        "type": "enriched",
        "enrichmentSource": "affinity-data",
        "value": {
          "type": "filterable-text",
          "data": "Public Markets"
        }
      },
      {
        "id": "affinity-data-investors",
        "name": "Investors",
        "type": "enriched",
        "enrichmentSource": "affinity-data",
        "value": {
          "type": "filterable-text-multi",
          "data": [
            "Marvin Acme",
            "Yosemite Sam"
          ]
        }
      },
      {
        "id": "affinity-data-last-funding-amount",
        "name": "Last Funding Amount (USD)",
        "type": "enriched",
        "enrichmentSource": "affinity-data",
        "value": {
          "type": "number",
          "data": 100000000
        }
      },
      {
        "id": "affinity-data-last-funding-date",
        "name": "Last Funding Date",
        "type": "enriched",
        "enrichmentSource": "affinity-data",
        "value": {
          "type": "datetime",
          "data": "2023-01-01T00:00:00Z"
        }
      },
      {
        "id": "affinity-data-linkedin-url",
        "name": "LinkedIn URL",
        "type": "enriched",
        "enrichmentSource": "affinity-data",
        "value": {
          "type": "text",
          "data": "https://linkedin.com/company/acme"
        }
      },
      {
        "id": "affinity-data-location",
        "name": "Location",
        "type": "enriched",
        "enrichmentSource": "affinity-data",
        "value": {
          "type": "location",
          "data": {
            "streetAddress": null,
            "city": "Fairfield",
            "state": "New Jersey",
            "country": "United States",
            "continent": null
          }
        }
      },
      {
        "id": "affinity-data-number-of-employees",
        "name": "Number of Employees",
        "type": "enriched",
        "enrichmentSource": "affinity-data",
        "value": {
          "type": "number",
          "data": 3990
        }
      },
      {
        "id": "affinity-data-total-funding-amount",
        "name": "Total Funding Amount (USD)",
        "type": "enriched",
        "enrichmentSource": "affinity-data",
        "value": {
          "type": "number",
          "data": 90000000
        }
      },
      {
        "id": "affinity-data-year-founded",
        "name": "Year Founded",
        "type": "enriched",
        "enrichmentSource": "affinity-data",
        "value": {
          "type": "number",
          "data": 1952
        }
      }
    ]
  },
  "creatorId": 1,
  "createdAt": "2023-01-01T00:00:00Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
listId
integer<int64>
required

List ID

Required range: 1 <= x <= 9007199254740991
​
listEntryId
integer<int64>
required

List Entry ID

Required range: 1 <= x <= 9007199254740991

Query Parameters

​
fieldIds
string[]

Field IDs for which to return field data

Example:
["field-1"]
​
fieldTypes
enum<string>[]

Field Types for which to return field data

Available options:
enriched,
global,
list,
relationship-intelligence

Response

OK

​
id
integer<int64>
required

The list entry's unique identifier

Required range: 1 <= x <= 9007199254740991
Example:

1

​
type
string
required

The entity type for this list entry

Allowed value: "company"
Example:

"company"

​
listId
integer<int64>
required

The ID of the list that this list entry belongs to

Required range: 1 <= x <= 9007199254740991
Example:

1

​
createdAt
string<date-time>
required

The date that the list entry was created

Example:

"2023-01-01T00:00:00Z"

​
creatorId
integer<int64> | null
required

The ID of the user that created this list entry

Required range: 1 <= x <= 9007199254740991
Example:

1

​
entity
Company · object
required

Company model

Example:
{
  "domain": "acme.co",
  "name": "Acme",
  "isGlobal": true,
  "domains": ["acme.co"],
  "id": 1,
  "fields": [
    {
      "enrichmentSource": "affinity-data",
      "name": "Location",
      "id": "affinity-data-location",
      "type": "enriched",
      "value": {
        "data": {
          "continent": "North America",
          "country": "United States",
          "streetAddress": "1 Main Street",
          "city": "San Francisco",
          "state": "California"
        },
        "type": "location"
      }
    },
    {
      "enrichmentSource": "affinity-data",
      "name": "Description",
      "id": "affinity-data-description",
      "type": "enriched",
      "value": {
        "data": "A leading provider of innovative solutions",
        "type": "text"
      }
    }
  ]
}