Skip to main content
GET
/
api
/
lists
/
{id}
/
companies
/
{cid}
Get a company row
curl --request GET \
  --url https://app.puffle.ai/api/lists/{id}/companies/{cid} \
  --header 'Authorization: Bearer <token>'
{ "company": { "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "listId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "domain": "<string>", "linkedinUrl": "<string>", "name": "<string>", "industry": "<string>", "employeeCount": "<string>", "employeeCountExact": 0, "foundedYear": 0, "fundingStage": "<string>", "fundingTotal": 123, "location": "<string>", "city": "<string>", "state": "<string>", "country": "<string>", "description": "<string>", "website": "<string>", "logoUrl": "<string>", "source": "<string>", "sourceId": "<string>", "createdAt": "2023-11-07T05:31:56Z", "updatedAt": "2023-11-07T05:31:56Z" } }

​
Overview

Return a single company row inside a list. Scopes to list ownership — a company that exists but belongs to a different list returns 404.
This operation shares the URL path /api/lists/{id}/companies/{cid} with other verbs. See the sibling page for related operations on the same resource.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string<uuid>
required

List UUID

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
cid
string<uuid>
required

Company row UUID

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Company row in camelCase.

​
company
object
required

camelCase company row shape returned by GET/PATCH.