> ## Documentation Index > Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Read a people search result > Read normalized output, delivery status, and total charges for an existing people search request. Follow the result_url returned by the call. Use `result_url` unchanged on the API origin and authenticate with a Key permitted to read every Run. The response uses the same fields as the initial Solution response. This read creates no Runs, calls no Providers and does not resume fallback. The link carries the action and the Runs, not the names, emails or other values you searched for. ## OpenAPI ````yaml /openapi.json get /v1/solutions/gtm/people_search/result openapi: 3.1.0 info: title: Glasser version: 0.0.1 description: >- One key, no contract, pay per call, across paid APIs bought wholesale. Every response carries x-request-id; every error body carries the same envelope. servers: - url: https://api.glasser.ai security: [] tags: - name: Solutions - name: Endpoints - name: Runs - name: Balance paths: /v1/solutions/gtm/people_search/result: get: tags: - Solutions summary: Read a people search result description: >- Follow result_url from a people search call to read normalized output, business result_status and the total charge of the same Runs. This authenticated read creates no Runs, calls no Providers and does not resume fallback. GET /v1/runs/:id remains the native individual Run. The result context is signed, bound to the Workspace and checked against the current Key policy for every Run. operationId: gtm-people-search-result parameters: - name: token in: query schema: type: string minLength: 1 maxLength: 16384 description: >- Opaque result context returned in result_url. Keep it unchanged and authenticate with a Key permitted to read every listed Run. required: true responses: '200': description: PeopleSearchResult content: application/json: schema: $ref: '#/components/schemas/PeopleSearchResult' '400': description: ValidationFailed content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationFailedEncoded' - $ref: '#/components/schemas/ValidationFailedEncoded' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/UnauthorizedEncoded' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ForbiddenEncoded' '404': description: NotFound content: application/json: schema: $ref: '#/components/schemas/NotFoundEncoded' '429': description: RateLimited content: application/json: schema: $ref: '#/components/schemas/RateLimitedEncoded' security: - bearer: [] components: schemas: PeopleSearchResult: type: object properties: id: type: string run_url: type: string description: Open this Run in the console. Requires Workspace membership. provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 status: type: string enum: - QUEUED - RUNNING - COMPLETED - FAILED - STOPPED description: >- QUEUED or RUNNING: still in progress. COMPLETED: a Provider response is available, including non-2xx responses. FAILED: read failure. STOPPED: stopped before dispatch. Read charge_usd separately from status. failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: Why the Run failed. Non-null only when status is FAILED. input: type: object output: anyOf: - anyOf: - type: object properties: total_matches: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- People matching the filters in the Provider's whole dataset, not only this page. Null when the Provider gives only the page count (LeadMagic). items: type: array items: type: object properties: name: anyOf: - type: string - type: 'null' description: >- Full name exactly as the Provider reports it (PDL is lower case). Null when the Provider gives only first and last name; never joined. first_name: anyOf: - type: string - type: 'null' description: First name as the Provider reports it. last_name: anyOf: - type: string - type: 'null' description: >- Last name as the Provider reports it. Null when the Provider masks it (Apollo search). job_title: anyOf: - type: string - type: 'null' description: Current job title as the Provider reports it. seniority: anyOf: - type: string - type: 'null' description: >- Seniority label in the answering Provider's own vocabulary (Apollo founder, PDL cxo, LeadMagic C-Team, Hunter executive). Not the request's seniorities vocabulary and not comparable across Providers; check provider. When the Provider lists several, the first. department: anyOf: - type: string - type: 'null' description: >- Department or job function in the answering Provider's own vocabulary. When the Provider lists several, the first. headline: anyOf: - type: string - type: 'null' description: Profile headline (the LinkedIn job-title line). linkedin_url: anyOf: - type: string - type: 'null' description: >- LinkedIn profile URL. https:// is added when the Provider omits a scheme. city: anyOf: - type: string - type: 'null' description: City of the person's location. region: anyOf: - type: string - type: 'null' description: State or region of the person's location. country: anyOf: - type: string - type: 'null' description: >- Country of the person's location as an English display name (never a code). country_code: anyOf: - type: string - type: 'null' description: >- Country of the person's location as an ISO 3166-1 alpha-2 code. email: anyOf: - type: string - type: 'null' description: >- Work email as the Provider reports it. PDL: work_email only; its other addresses stay on the Run. email_status: anyOf: - type: string - type: 'null' description: >- The answering Provider's own verification label for email (Apollo verified, Prospeo VERIFIED, Hunter and LeadMagic valid). Providers verify differently, so the labels are not comparable; read it with email_catch_all and email_source. email_catch_all: anyOf: - type: boolean - type: 'null' description: >- True when the Provider reports that the email's domain accepts every address, so a mailbox check cannot confirm this one (Hunter accept_all, Apollo email_domain_catchall). email_source: anyOf: - type: string - type: 'null' description: >- How Hunter got the email: found (seen on the web) or generated (built from the domain's address pattern). Null for other Providers. phone: anyOf: - type: string - type: 'null' description: >- Phone number as the Provider reports it. Masked numbers are left out. company_name: anyOf: - type: string - type: 'null' description: Current employer as the Provider reports it. company_domain: anyOf: - type: string - type: 'null' description: >- Current employer's domain (hostname without www. or port). company_linkedin_url: anyOf: - type: string - type: 'null' description: Current employer's LinkedIn company page URL. apollo_match_confidence: anyOf: - type: string - type: 'null' description: >- Apollo's confidence that the record matches the input: high, medium, low or none. Null for other Providers. pdl_likelihood: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- People Data Labs' 1-10 score for how well the record matches the input. Null for other Providers. hunter_email_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Hunter's 0-100 confidence in email (email-finder score, domain-search confidence). Null for other Providers. zoominfo_accuracy_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- ZoomInfo's 0-100 contact accuracy score. Null for other Providers. required: - name - first_name - last_name - job_title - seniority - department - headline - linkedin_url - city - region - country - country_code - email - email_status - email_catch_all - email_source - phone - company_name - company_domain - company_linkedin_url - apollo_match_confidence - pdl_likelihood - hunter_email_score - zoominfo_accuracy_score additionalProperties: false required: - total_matches - items additionalProperties: false - type: object properties: name: anyOf: - type: string - type: 'null' description: >- Full name exactly as the Provider reports it (PDL is lower case). Null when the Provider gives only first and last name; never joined. first_name: anyOf: - type: string - type: 'null' description: First name as the Provider reports it. last_name: anyOf: - type: string - type: 'null' description: >- Last name as the Provider reports it. Null when the Provider masks it (Apollo search). job_title: anyOf: - type: string - type: 'null' description: Current job title as the Provider reports it. seniority: anyOf: - type: string - type: 'null' description: >- Seniority label in the answering Provider's own vocabulary (Apollo founder, PDL cxo, LeadMagic C-Team, Hunter executive). Not the request's seniorities vocabulary and not comparable across Providers; check provider. When the Provider lists several, the first. department: anyOf: - type: string - type: 'null' description: >- Department or job function in the answering Provider's own vocabulary. When the Provider lists several, the first. headline: anyOf: - type: string - type: 'null' description: Profile headline (the LinkedIn job-title line). linkedin_url: anyOf: - type: string - type: 'null' description: >- LinkedIn profile URL. https:// is added when the Provider omits a scheme. city: anyOf: - type: string - type: 'null' description: City of the person's location. region: anyOf: - type: string - type: 'null' description: State or region of the person's location. country: anyOf: - type: string - type: 'null' description: >- Country of the person's location as an English display name (never a code). country_code: anyOf: - type: string - type: 'null' description: >- Country of the person's location as an ISO 3166-1 alpha-2 code. email: anyOf: - type: string - type: 'null' description: >- Work email as the Provider reports it. PDL: work_email only; its other addresses stay on the Run. email_status: anyOf: - type: string - type: 'null' description: >- The answering Provider's own verification label for email (Apollo verified, Prospeo VERIFIED, Hunter and LeadMagic valid). Providers verify differently, so the labels are not comparable; read it with email_catch_all and email_source. email_catch_all: anyOf: - type: boolean - type: 'null' description: >- True when the Provider reports that the email's domain accepts every address, so a mailbox check cannot confirm this one (Hunter accept_all, Apollo email_domain_catchall). email_source: anyOf: - type: string - type: 'null' description: >- How Hunter got the email: found (seen on the web) or generated (built from the domain's address pattern). Null for other Providers. phone: anyOf: - type: string - type: 'null' description: >- Phone number as the Provider reports it. Masked numbers are left out. company_name: anyOf: - type: string - type: 'null' description: Current employer as the Provider reports it. company_domain: anyOf: - type: string - type: 'null' description: >- Current employer's domain (hostname without www. or port). company_linkedin_url: anyOf: - type: string - type: 'null' description: Current employer's LinkedIn company page URL. apollo_match_confidence: anyOf: - type: string - type: 'null' description: >- Apollo's confidence that the record matches the input: high, medium, low or none. Null for other Providers. pdl_likelihood: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- People Data Labs' 1-10 score for how well the record matches the input. Null for other Providers. hunter_email_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Hunter's 0-100 confidence in email (email-finder score, domain-search confidence). Null for other Providers. zoominfo_accuracy_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- ZoomInfo's 0-100 contact accuracy score. Null for other Providers. required: - name - first_name - last_name - job_title - seniority - department - headline - linkedin_url - city - region - country - country_code - email - email_status - email_catch_all - email_source - phone - company_name - company_domain - company_linkedin_url - apollo_match_confidence - pdl_likelihood - hunter_email_score - zoominfo_accuracy_score additionalProperties: false - type: 'null' description: >- Normalized fields per action; enrich and find_email return one person with the same fields as a search row. The Provider's native output is not repeated here; it stays on the Run (GET /v1/runs/:id). Values a Provider does not report are null; an empty answer is the action's shape with every field null, or items: [], with result_status no_result. Names, titles and labels are as the Provider reports them. A score from a Provider's own model is named after the Provider (pdl_likelihood) and is null for the others. - search: total_matches, items[]: name, first_name, last_name, job_title, seniority, department, headline, linkedin_url, city, region, country, country_code, email, email_status, email_catch_all, email_source, phone, company_name, company_domain, company_linkedin_url, apollo_match_confidence, pdl_likelihood, hunter_email_score, zoominfo_accuracy_score - enrich: name, first_name, last_name, job_title, seniority, department, headline, linkedin_url, city, region, country, country_code, email, email_status, email_catch_all, email_source, phone, company_name, company_domain, company_linkedin_url, apollo_match_confidence, pdl_likelihood, hunter_email_score, zoominfo_accuracy_score - find_email: name, first_name, last_name, job_title, seniority, department, headline, linkedin_url, city, region, country, country_code, email, email_status, email_catch_all, email_source, phone, company_name, company_domain, company_linkedin_url, apollo_match_confidence, pdl_likelihood, hunter_email_score, zoominfo_accuracy_score provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: >- HTTP status returned by the Provider. Check this even when the Run is COMPLETED. error: anyOf: - {} - type: 'null' required: - http_status additionalProperties: false - type: 'null' description: >- Non-null only when status is COMPLETED. - For 2xx responses, output contains Provider-native JSON (any shape), or null for an empty body. - For non-2xx responses, error contains the Provider's error body and output is null. Sensitive fields are removed from both bodies. charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats. - type: 'null' description: >- Total charge of runs in this Solution response. Null until all listed Runs settle. Each Run retains its own charge; failures can also be charged. charge_basis: anyOf: - type: object properties: clause: type: string enum: - rule - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL quantity: anyOf: - type: integer minimum: 0 - type: 'null' required: - clause - quantity additionalProperties: false - type: 'null' description: >- Single-Run charge basis, or null for a multi-Run total. Read runs[].charge_basis for each charge. stoppable: type: boolean description: >- Whether a stop request can currently be accepted. This does not guarantee that the Run can stop before dispatch. stop_requested_at: anyOf: - type: string description: ISO-8601 UTC timestamp format: date-time - type: 'null' description: >- When a stop was requested. The Run can still continue if dispatch had already started. created_at: type: string description: ISO-8601 UTC timestamp format: date-time started_at: anyOf: - type: string description: ISO-8601 UTC timestamp format: date-time - type: 'null' completed_at: anyOf: - type: string description: ISO-8601 UTC timestamp format: date-time - type: 'null' task_id: anyOf: - type: string - type: 'null' metadata: type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: >- Your stored tracking fields. Use them to filter Runs. They never go to the Provider or affect routing, Price, or idempotency. - Up to 20 keys: lowercase letters, digits, and underscores; start with a letter; at most 40 characters. - Values: strings of 1–500 characters. - user_id: your End user's opaque ID, never their email address or name. action: type: string enum: - search - enrich - find_email result_status: type: string enum: - success - no_result - error - pending description: >- Business delivery status, independent of the final Run lifecycle in status. no_result is an empty but valid answer; error means the Provider output could not be delivered. error: anyOf: - type: object properties: code: type: string message: type: string required: - code - message additionalProperties: false - type: 'null' runs: type: array items: type: object properties: id: type: string run_url: type: string description: Open this Run in the console. Requires Workspace membership. provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 status: type: string enum: - QUEUED - RUNNING - COMPLETED - FAILED - STOPPED description: >- QUEUED or RUNNING: still in progress. COMPLETED: a Provider response is available, including non-2xx responses. FAILED: read failure. STOPPED: stopped before dispatch. Read charge_usd separately from status. failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: Why the Run failed. Non-null only when status is FAILED. input: type: object properties: omitted: type: boolean enum: - true required: - omitted additionalProperties: false output: type: object properties: omitted: type: boolean enum: - true required: - omitted additionalProperties: false provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: >- HTTP status returned by the Provider. Check this even when the Run is COMPLETED. required: - http_status additionalProperties: false - type: 'null' charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats. - type: 'null' description: >- Final charge as an exact USD decimal string. Null while QUEUED or RUNNING. A FAILED Run can have a non-zero charge under the Endpoint's Price. charge_basis: anyOf: - type: object properties: clause: type: string enum: - rule - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL quantity: anyOf: - type: integer minimum: 0 - type: 'null' required: - clause - quantity additionalProperties: false - type: 'null' description: >- Price clause used to calculate the charge. Null before settlement or when no Provider attempt was made. stoppable: type: boolean description: >- Whether a stop request can currently be accepted. This does not guarantee that the Run can stop before dispatch. stop_requested_at: anyOf: - type: string description: ISO-8601 UTC timestamp format: date-time - type: 'null' description: >- When a stop was requested. The Run can still continue if dispatch had already started. created_at: type: string description: ISO-8601 UTC timestamp format: date-time started_at: anyOf: - type: string description: ISO-8601 UTC timestamp format: date-time - type: 'null' completed_at: anyOf: - type: string description: ISO-8601 UTC timestamp format: date-time - type: 'null' task_id: anyOf: - type: string - type: 'null' metadata: type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: >- Your stored tracking fields. Use them to filter Runs. They never go to the Provider or affect routing, Price, or idempotency. - Up to 20 keys: lowercase letters, digits, and underscores; start with a letter; at most 40 characters. - Values: strings of 1–500 characters. - user_id: your End user's opaque ID, never their email address or name. required: - id - run_url - provider - endpoint - endpoint_version - status - failure - input - output - provider_response - charge_usd - charge_basis - stoppable - stop_requested_at - created_at - started_at - completed_at - task_id - metadata additionalProperties: false result_url: type: string description: >- Authenticated, read-only URL path for polling this normalized result and total charge. Use with the API origin. Does not create Runs or resume fallback. GET /v1/runs/:id still returns the native, individual Run. required: - id - run_url - provider - endpoint - endpoint_version - status - failure - input - output - provider_response - charge_usd - charge_basis - stoppable - stop_requested_at - created_at - started_at - completed_at - task_id - metadata - action - result_status - error - runs - result_url additionalProperties: false ValidationFailedEncoded: type: object properties: error: type: object properties: code: type: string enum: - validation_failed message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false UnauthorizedEncoded: type: object properties: error: type: object properties: code: type: string enum: - unauthorized message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false ForbiddenEncoded: type: object properties: error: type: object properties: code: type: string enum: - forbidden message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false NotFoundEncoded: type: object properties: error: type: object properties: code: type: string enum: - not_found message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false RateLimitedEncoded: type: object properties: error: type: object properties: code: type: string enum: - rate_limited message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false securitySchemes: bearer: type: http scheme: Bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.