Properties
| Name | Type | Description |
|---|---|---|
| entity | string | |
| platform | object | |
| canonical_url | object | |
| data_as_of | object | |
| schema_version | string | |
| common | object | |
| platform_fields | object | |
| freshness | object | |
| usage | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/veezee-io/json-schema/veezee-io-person-envelope-schema.json",
"title": "person_envelope",
"x-generated": "2026-10-29",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/veezee-io-openapi.json#/components/schemas/person_envelope",
"type": "object",
"properties": {
"entity": {
"type": "string",
"const": "person"
},
"platform": {
"anyOf": [
{
"type": "string",
"enum": [
"linkedin",
"reddit",
"x"
]
},
{
"type": "null"
}
]
},
"canonical_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data_as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"schema_version": {
"type": "string",
"const": "2"
},
"common": {
"type": "object",
"properties": {
"full_name": {
"type": "string"
},
"first_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"last_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"headline": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"location": {
"anyOf": [
{
"type": "object",
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Human-readable place, e.g. 'Seattle, Washington'."
},
"country_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "ISO 3166-1 alpha-2 when known."
}
},
"required": [
"name",
"country_code"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"about": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Only present when the 'about' section was requested."
},
"current_position": {
"anyOf": [
{
"type": "object",
"properties": {
"company_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"company_handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "LinkedIn company slug."
},
"company_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"company_urn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"start_year": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"company_name",
"company_handle",
"company_url",
"company_urn",
"start_year"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"experience": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"company": {
"type": "object",
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"handle",
"url"
],
"additionalProperties": false
},
"positions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"is_current": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"start_date": {
"anyOf": [
{
"type": "object",
"properties": {
"month": {
"anyOf": [
{
"type": "integer",
"minimum": 1,
"maximum": 12
},
{
"type": "null"
}
]
},
"year": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"month",
"year"
],
"additionalProperties": false,
"description": "Partial date as LinkedIn exposes it; month may be unknown."
},
{
"type": "null"
}
]
},
"end_date": {
"anyOf": [
{
"type": "object",
"properties": {
"month": {
"anyOf": [
{
"type": "integer",
"minimum": 1,
"maximum": 12
},
{
"type": "null"
}
]
},
"year": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"month",
"year"
],
"additionalProperties": false,
"description": "Partial date as LinkedIn exposes it; month may be unknown."
},
{
"type": "null"
}
]
}
},
"required": [
"role",
"location",
"is_current",
"start_date",
"end_date"
],
"additionalProperties": false
}
}
},
"required": [
"company",
"positions"
],
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Only present when the 'experience' section was requested."
},
"education": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"institution": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"institution_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"degree": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"start_year": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"end_year": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"institution",
"institution_url",
"degree",
"start_year",
"end_year"
],
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Only present when the 'education' section was requested."
},
"skills": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"endorsement_count": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"endorsement_count"
],
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Only present when the 'skills' section was requested."
},
"followers": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"connections": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"is_verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string",
"description": "Canonical LinkedIn profile URL."
}
},
"required": [
"full_name",
"first_name",
"last_name",
"headline",
"location",
"about",
"current_position",
"experience",
"education",
"skills",
"followers",
"connections",
"is_verified",
"image_url",
"url"
],
"additionalProperties": false
},
"platform_fields": {
"type": "object",
"properties": {
"urn": {
"type": "string",
"description": "Stable LinkedIn URN (urn:li:fsd_profile:...). Use this for repeat lookups."
},
"public_identifier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Profile slug after /in/."
},
"is_influencer": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"is_creator": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"is_hiring": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"has_premium": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"open_to_messages": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"pronoun": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"urn",
"public_identifier",
"is_influencer",
"is_creator",
"is_hiring",
"has_premium",
"open_to_messages",
"pronoun"
],
"additionalProperties": false
},
"freshness": {
"anyOf": [
{
"type": "object",
"properties": {
"source_retrieved_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When the data was fetched from the source. ISO 8601."
},
"served_at": {
"type": "string"
},
"cache_age_seconds": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"served_from_cache": {
"type": "boolean",
"description": "True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are."
},
"freshness_requested": {
"type": "string",
"enum": [
"recent",
"realtime"
]
},
"freshness_served": {
"type": "string",
"enum": [
"recent",
"realtime",
"stale"
]
}
},
"required": [
"source_retrieved_at",
"served_at",
"cache_age_seconds",
"served_from_cache",
"freshness_requested",
"freshness_served"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"usage": {
"type": "object",
"properties": {
"receipt_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"credits_quoted": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"credits_charged": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"balance_remaining": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"free_tier_hint": {
"description": "Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits).",
"type": "string"
}
},
"required": [
"receipt_id",
"credits_quoted",
"credits_charged",
"balance_remaining"
],
"additionalProperties": false
}
},
"required": [
"entity",
"platform",
"canonical_url",
"data_as_of",
"schema_version",
"common",
"platform_fields",
"freshness",
"usage"
],
"additionalProperties": false
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/veezee-io-person-envelope"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.