Properties
| Name | Type | Description |
|---|---|---|
| profile_id | string | |
| canonical_id | string | Search id for this person when both profile ids are known. |
| contacts | object | |
| credits | number | Credits charged for this person on the lookup. 0 on a miss, a cache hit, a pending lookup, and when this response did not itself charge. |
| cost | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/recruitmcp-com/json-schema/recruitmcp-com-contacts-schema.json",
"title": "Contacts",
"x-generated": "2026-10-31",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/recruitmcp-com-openapi.json#/components/schemas/Contacts",
"type": "object",
"properties": {
"profile_id": {
"type": "string"
},
"canonical_id": {
"type": "string",
"description": "Search id for this person when both profile ids are known."
},
"contacts": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ready",
"not_found",
"pending",
"expired"
]
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"type": {
"type": [
"string",
"null"
],
"enum": [
"personal",
"work"
],
"description": "work or personal when the lookup provides it. Null when it does not."
},
"line": {
"type": "string",
"enum": [
"mobile",
"work_phone",
"work",
"personal"
],
"description": "Provider line. mobile and work_phone stay on phones."
},
"confidence": {
"type": [
"number",
"null"
]
},
"flagged": {
"type": "boolean",
"description": "True when a plausibility check says this entry is clearly not this person."
},
"flag_reason": {
"type": "string",
"description": "Short reason, at most 12 words. Present when flagged is true."
}
}
}
},
"phones": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"personal",
"work"
]
},
"line": {
"type": "string",
"enum": [
"mobile",
"work_phone",
"work",
"personal"
],
"description": "Provider line. mobile and work_phone stay on phones."
},
"confidence": {
"type": [
"number",
"null"
]
},
"flagged": {
"type": "boolean",
"description": "True when a plausibility check says this entry is clearly not this person."
},
"flag_reason": {
"type": "string",
"description": "Short reason, at most 12 words. Present when flagged is true."
}
}
}
},
"best_email": {
"type": [
"object",
"null"
],
"properties": {
"value": {
"type": "string"
},
"type": {
"type": [
"string",
"null"
],
"enum": [
"personal",
"work"
],
"description": "work or personal when the lookup provides it. Null when it does not."
},
"line": {
"type": "string",
"enum": [
"mobile",
"work_phone",
"work",
"personal"
],
"description": "Provider line. mobile and work_phone stay on phones."
},
"confidence": {
"type": [
"number",
"null"
]
},
"reason": {
"type": "string",
"enum": [
"only_candidate",
"mobile",
"highest_rating",
"personal_preferred",
"work_preferred",
"matches_employer_domain",
"llm_plausibility"
],
"description": "Why this address or number was chosen. llm_plausibility means a flagged entry changed the pick."
}
},
"required": [
"value",
"type",
"confidence",
"reason"
]
},
"best_phone": {
"type": [
"object",
"null"
],
"properties": {
"value": {
"type": "string"
},
"type": {
"type": [
"string",
"null"
],
"enum": [
"personal",
"work"
],
"description": "work or personal when the lookup provides it. Null when it does not."
},
"line": {
"type": "string",
"enum": [
"mobile",
"work_phone",
"work",
"personal"
],
"description": "Provider line. mobile and work_phone stay on phones."
},
"confidence": {
"type": [
"number",
"null"
]
},
"reason": {
"type": "string",
"enum": [
"only_candidate",
"mobile",
"highest_rating",
"personal_preferred",
"work_preferred",
"matches_employer_domain",
"llm_plausibility"
],
"description": "Why this address or number was chosen. llm_plausibility means a flagged entry changed the pick."
}
},
"required": [
"value",
"type",
"confidence",
"reason"
]
},
"expires_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"required": [
"status",
"emails",
"phones",
"best_email",
"best_phone"
]
},
"credits": {
"type": "number",
"description": "Credits charged for this person on the lookup. 0 on a miss, a cache hit, a pending lookup, and when this response did not itself charge."
},
"cost": {
"$ref": "#/$defs/Cost"
}
},
"required": [
"profile_id",
"contacts"
],
"$defs": {
"Cost": {
"type": "object",
"properties": {
"credits": {
"type": "integer",
"description": "Credits charged by this call. Whole credits. 0 on an idempotent replay, where the body also has replayed: true and the header Idempotent-Replayed: true."
},
"cached_items": {
"type": "integer",
"description": "Items read from cache. On a replay, the value of the first response."
},
"live_items": {
"type": "integer",
"description": "Items fetched live by this call. 0 on a replay."
},
"upstream_calls": {
"type": "integer",
"description": "Index calls made by this call. 0 on a replay."
}
},
"required": [
"credits"
]
}
}
}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/recruitmcp-com-contacts"
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.