Lookup Prospect

Lookup prospect

curl --request GET \
  --url https://inboxapp.com/api/v1/prospects/lookup

{
  "platform": "twitter",
  "platformId": "<string>",
  "externalId": "l44e15irdq4db30i77cgphhx",
  "documentId": 858224163,
  "displayName": "<string>",
  "username": "<string>",
  "handle": "<string>",
  "image": "https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg",
  "imageNormalized": "https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg",
  "bio": "Social Selling CRM Close deals faster, stay organized, and never miss an opportunity. Starting with X",
  "location": "San Francisco, CA",
  "profileUrl": "<string>",
  "websiteUrl": "https://inboxapp.com",
  "websiteDomain": "inboxapp.com",
  "verified": "none",
  "profileType": "personal",
  "isProtected": true,
  "followerCount": 123,
  "followingCount": 123,
  "postCount": 123,
  "engagementCount": 2613,
  "listedCount": 18,
  "platformCreatedAt": "2022-09-03T17:58:06.000Z",
  "firstSeenAt": "2024-07-09T14:08:49.000Z",
  "lastUpdatedAt": "2023-11-07T05:31:56Z",
  "lastEnrichedAt": "2025-11-10T18:03:16.000Z",
  "lastActiveAt": "2025-11-10T12:00:00.000Z",
  "source": "cached",
  "isFresh": true,
  "isStale": true,
  "confidence": 0.5,
  "platformData": {
    "isVerifiedBlue": true,
    "isVerifiedGold": true,
    "isVerifiedGray": true,
    "professionalCategory": "986",
    "urlEntities": [
      {
        "url": "<string>",
        "expandedUrl": "<string>",
        "displayUrl": "<string>",
        "indices": "<array>"
      }
    ],
    "bannerUrl": "https://pbs.twimg.com/profile_banners/1566123362161725440/1753273968",
    "tweetsCount": 123,
    "favoritesCount": 123,
    "rawData": {}
  },
  "context": {
    "tags": [
      "<string>"
    ],
    "statusId": "df6jbw4h36...",
    "valuation": 599,
    "notes": "This prospect is a potential customer.",
    "threads": [
      {
        "id": "<string>",
        "accountLinkId": "<string>",
        "lastMessageTimestamp": "2023-11-07T05:31:56Z",
        "createdAt": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

GET

prospects

lookup

Lookup prospect

curl --request GET \
  --url https://inboxapp.com/api/v1/prospects/lookup

{
  "platform": "twitter",
  "platformId": "<string>",
  "externalId": "l44e15irdq4db30i77cgphhx",
  "documentId": 858224163,
  "displayName": "<string>",
  "username": "<string>",
  "handle": "<string>",
  "image": "https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg",
  "imageNormalized": "https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg",
  "bio": "Social Selling CRM Close deals faster, stay organized, and never miss an opportunity. Starting with X",
  "location": "San Francisco, CA",
  "profileUrl": "<string>",
  "websiteUrl": "https://inboxapp.com",
  "websiteDomain": "inboxapp.com",
  "verified": "none",
  "profileType": "personal",
  "isProtected": true,
  "followerCount": 123,
  "followingCount": 123,
  "postCount": 123,
  "engagementCount": 2613,
  "listedCount": 18,
  "platformCreatedAt": "2022-09-03T17:58:06.000Z",
  "firstSeenAt": "2024-07-09T14:08:49.000Z",
  "lastUpdatedAt": "2023-11-07T05:31:56Z",
  "lastEnrichedAt": "2025-11-10T18:03:16.000Z",
  "lastActiveAt": "2025-11-10T12:00:00.000Z",
  "source": "cached",
  "isFresh": true,
  "isStale": true,
  "confidence": 0.5,
  "platformData": {
    "isVerifiedBlue": true,
    "isVerifiedGold": true,
    "isVerifiedGray": true,
    "professionalCategory": "986",
    "urlEntities": [
      {
        "url": "<string>",
        "expandedUrl": "<string>",
        "displayUrl": "<string>",
        "indices": "<array>"
      }
    ],
    "bannerUrl": "https://pbs.twimg.com/profile_banners/1566123362161725440/1753273968",
    "tweetsCount": 123,
    "favoritesCount": 123,
    "rawData": {}
  },
  "context": {
    "tags": [
      "<string>"
    ],
    "statusId": "df6jbw4h36...",
    "valuation": 599,
    "notes": "This prospect is a potential customer.",
    "threads": [
      {
        "id": "<string>",
        "accountLinkId": "<string>",
        "lastMessageTimestamp": "2023-11-07T05:31:56Z",
        "createdAt": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

Query Parameters

platformId

string

required

The platform user ID (e.g., Twitter user ID).

Response

200 - application/json

object | null

platform

enum<string>

required

The social platform where this prospect's profile exists.

Available options:

twitter,

sandbox

platformId

string

required

The platform's native user ID. For Twitter, this is the numeric user ID. This is the primary identifier for cross-platform operations.

externalId

string | null

required

Unique identifier for this prospect in the Inbox system. Null if the prospect hasn't been imported yet.

Example:

"l44e15irdq4db30i77cgphhx"

documentId

number | null

required

Search index identifier for fast lookups. Null if the prospect isn't indexed yet.

Example:

858224163

displayName

string

required

The user's display name as shown on their profile. For businesses, typically the company name.

username

string

required

The unique handle/username on the platform, without the @ symbol. Always lowercase for Twitter.

handle

string

required

The username with @ symbol prefix, ready for display in UI. Computed from username.

image

string | null

required

Profile picture URL as provided by platform. May contain size suffixes or be lower quality. Prefer imageNormalized for display.

Example:

"https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg"

imageNormalized

string | null

required

Profile picture URL normalized to highest quality available. Size suffixes removed. Prefer this over image for display.

Example:

"https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg"

bio

string | null

required

The user's profile bio/description text.

Example:

"Social Selling CRM Close deals faster, stay organized, and never miss an opportunity. Starting with X"

location

string | null

required

Freeform location string as entered by user. Not normalized or geocoded.

Example:

"San Francisco, CA"

profileUrl

string

required

Direct link to view this profile on the platform.

websiteUrl

string | null

required

External website URL the user provided in their profile, if any.

Example:

"https://inboxapp.com"

websiteDomain

string | null

required

Domain extracted from websiteUrl for quick filtering and grouping.

Example:

"inboxapp.com"

verified

enum<string>

required

Verification badge status: none (no badge), verified (blue checkmark), business (gold badge), or government (gray badge).

Available options:

none,

verified,

business,

government

profileType

enum<string>

required

Account type classification: personal (individual), business (organization), or government (official agency).

Available options:

personal,

business,

government

isProtected

boolean

required

Whether the account is private/protected. For Twitter: protected tweets enabled. Private accounts require approval to follow.

followerCount

number

required

Number of users following this account.

followingCount

number

required

Number of users this account follows.

postCount

number

required

Total content posted by this account. For Twitter: tweet count. For Instagram: post count.

engagementCount

number | null

required

Platform-specific engagement metric. For Twitter: likes/favorites given by user. May be null if platform doesn't provide this.

Example:

2613

listedCount

number | null

required

How many Twitter lists this profile appears on. Useful metric for influence. Null for non-Twitter platforms.

Example:

18

platformCreatedAt

string<date-time> | null

required

When the account was created on the platform. Null if platform doesn't provide this data.

Example:

"2022-09-03T17:58:06.000Z"

firstSeenAt

string<date-time> | null

required

When this prospect was first added to Inbox. Useful for tracking relationship timeline.

Example:

"2024-07-09T14:08:49.000Z"

lastUpdatedAt

string<date-time>

required

Most recent update timestamp for any data about this prospect.

lastEnrichedAt

string<date-time> | null

required

When fresh data was last fetched from the platform API. Use this to determine if data needs refresh.

Example:

"2025-11-10T18:03:16.000Z"

lastActiveAt

string<date-time> | null

required

Last time the profile was active on the platform (posted, liked, or engaged). Platform-dependent availability.

Example:

"2025-11-10T12:00:00.000Z"

source

enum<string>

required

Data source: cached (stored), indexed (searchable), live (real-time from platform), or merged (combined sources).

Available options:

cached,

indexed,

live,

merged

isFresh

boolean

required

Indicates if data was updated within the last 7 days. Fresh data is current and reliable.

isStale

boolean

required

Indicates if data hasn't been updated in over 30 days. Stale data may need refreshing for accuracy.

confidence

number

required

Confidence score for data accuracy (0-1). Higher values indicate more recent and reliable data. 1.0 = real-time, 0.8+ = recent, below 0.5 = potentially outdated.

Required range: 0 <= x <= 1

platformData

object

required

Show child attributes

platformData.isVerifiedBlue

boolean

required

Standard Twitter blue checkmark verification badge.

platformData.isVerifiedGold

boolean

required

Gold verification badge indicating a business/brand account on Twitter.

platformData.isVerifiedGray

boolean

required

Gray verification badge indicating a government/official account on Twitter.

platformData.professionalCategory

string | null

required

Professional category ID if the account has set one. Maps to categories like Technology, Media, Education, etc.

Example:

"986"

platformData.urlEntities

object[]

required

Parsed URL entities from the bio text with expanded and display URLs.

Show child attributes

platformData.urlEntities.url

string

required

Shortened t.co URL as it appears in the tweet text.

platformData.urlEntities.expandedUrl

string

required

Full expanded URL that the t.co link redirects to.

platformData.urlEntities.displayUrl

string

required

Human-readable display text for the URL (typically domain + path).

platformData.urlEntities.indices

array

required

Start and end character indices where this URL appears in the bio text.

platformData.bannerUrl

string | null

required

Profile banner/header image URL (typically 1500x500px). Null if no banner is set.

Example:

"https://pbs.twimg.com/profile_banners/1566123362161725440/1753273968"

platformData.tweetsCount

number

required

Total number of tweets posted by this account (all-time count).

platformData.favoritesCount

number

required

Total number of likes/favorites this user has given to other tweets.

platformData.rawData

object

required

Full Twitter API user object for backward compatibility and advanced use cases. Null if not available from the data source.

Show child attributes

platformData.rawData.{key}

any

context

object

required

Show child attributes

context.tags

string[]

required

The tag IDs attached to this prospect.

context.statusId

string | null

required

The status ID of the prospect.

Example:

"df6jbw4h36..."

context.valuation

number | null

required

The valuation of the prospect.

Example:

599

context.notes

string | null

required

Notes attached to the prospect.

Example:

"This prospect is a potential customer."

context.threads

object[] | null

Threads across all accounts linked to this prospect.

Show child attributes

context.threads.id

string

required

context.threads.accountLinkId

string

required

context.threads.lastMessageTimestamp

string<date-time> | null

required

context.threads.createdAt

string<date-time>

required

Get Member Get Prospect

⌘I

Getting Started

Teams

Threads

Messages

Account Links

Members

Prospects

Tags

Statuses

Colors

Query Parameters

Response