> ## 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. # Ler o resultado de uma busca de pessoas > Leia a saída normalizada, o status de entrega e o total de cobranças de uma solicitação de busca de pessoas existente. Siga o result_url retornado pela chamada. Use `result_url` sem alterações na origem da API e autentique-se com uma Key autorizada a ler todos os Runs. A resposta usa os mesmos campos da resposta inicial da Solution. Esta leitura não cria Runs, não chama provedores de dados e não retoma o fallback. O link transporta a ação e os Runs, não os nomes, e-mails ou outros valores pesquisados. ## OpenAPI ````yaml /openapi.pt.json get /v1/solutions/gtm/people_search/result openapi: 3.1.0 info: title: Glasser version: 0.0.1 description: >- Uma chave, sem contrato, pagamento por chamada, para todas as APIs pagas adquiridas no atacado. Cada resposta contém x-request-id; cada corpo de erro contém o mesmo 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: Ler um resultado de pesquisa de pessoas description: >- Siga result_url de uma chamada de pesquisa de pessoas para ler a saída normalizada, o result_status comercial e a cobrança total dos mesmos Runs. Esta leitura autenticada não cria Runs, não chama provedores de dados e não retoma o fallback. GET /v1/runs/:id continua sendo o Run individual nativo. O contexto do resultado é assinado, vinculado ao Workspace e verificado em relação à política atual da Key para cada Run. operationId: gtm-people-search-result parameters: - name: token in: query schema: type: string minLength: 1 maxLength: 16384 description: >- Contexto opaco do resultado retornado em result_url. Mantenha-o inalterado e autentique-se com uma Key autorizada a ler todos os Runs listados. 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: Abra este Run no console. Requer associação ao Workspace. 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 ou RUNNING: ainda em andamento. COMPLETED: uma resposta do provedor de dados está disponível, incluindo respostas não 2xx. FAILED: consulte `failure`. STOPPED: interrompido antes do envio. Leia charge_usd separadamente de status. failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: Motivo da falha do Run. Não nulo somente quando status é 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: >- Pessoas que correspondem aos filtros em todo o conjunto de dados do provedor de dados, não apenas nesta página. Nulo quando o provedor de dados fornece somente a contagem da página (LeadMagic). items: type: array items: type: object properties: name: anyOf: - type: string - type: 'null' description: >- Nome completo exatamente como informado pelo provedor de dados (PDL usa letras minúsculas). Nulo quando o provedor de dados fornece apenas nome e sobrenome; nunca concatenado. first_name: anyOf: - type: string - type: 'null' description: Nome conforme informado pelo provedor de dados. last_name: anyOf: - type: string - type: 'null' description: >- Sobrenome conforme informado pelo provedor de dados. Nulo quando o provedor de dados o mascara (pesquisa do Apollo). job_title: anyOf: - type: string - type: 'null' description: >- Cargo atual conforme informado pelo provedor de dados. seniority: anyOf: - type: string - type: 'null' description: >- Rótulo de senioridade no vocabulário próprio do provedor de dados que respondeu (Apollo founder, PDL cxo, LeadMagic C-Team, Hunter executive). Não é o vocabulário de seniorities da solicitação e não é comparável entre provedores de dados; verifique provider. Quando o provedor de dados lista vários, o primeiro. department: anyOf: - type: string - type: 'null' description: >- Departamento ou função profissional no vocabulário próprio do provedor de dados que respondeu. Quando o provedor de dados lista vários, o primeiro. headline: anyOf: - type: string - type: 'null' description: Título do perfil (a linha de cargo do LinkedIn). linkedin_url: anyOf: - type: string - type: 'null' description: >- URL do perfil no LinkedIn. https:// é adicionado quando o provedor de dados omite o esquema. city: anyOf: - type: string - type: 'null' description: Cidade da localização da pessoa. region: anyOf: - type: string - type: 'null' description: Estado ou região da localização da pessoa. country: anyOf: - type: string - type: 'null' description: >- País da localização da pessoa como nome de exibição em inglês (nunca um código). country_code: anyOf: - type: string - type: 'null' description: >- País da localização da pessoa como código ISO 3166-1 alpha-2. email: anyOf: - type: string - type: 'null' description: >- E-mail profissional conforme informado pelo provedor de dados. PDL: somente work_email; os demais endereços permanecem no Run. email_status: anyOf: - type: string - type: 'null' description: >- Rótulo próprio de verificação de e-mail do provedor de dados que respondeu (Apollo verified, Prospeo VERIFIED, Hunter e LeadMagic valid). Os provedores de dados verificam de maneiras diferentes, portanto os rótulos não são comparáveis; leia-o com email_catch_all e email_source. email_catch_all: anyOf: - type: boolean - type: 'null' description: >- Verdadeiro quando o provedor de dados informa que o domínio do e-mail aceita todos os endereços, portanto uma verificação de caixa de entrada não pode confirmar este endereço (Hunter accept_all, Apollo email_domain_catchall). email_source: anyOf: - type: string - type: 'null' description: >- Como o Hunter obteve o e-mail: found (encontrado na web) ou generated (gerado a partir do padrão de endereços do domínio). Nulo para outros provedores de dados. phone: anyOf: - type: string - type: 'null' description: >- Número de telefone conforme informado pelo provedor de dados. Números mascarados são omitidos. company_name: anyOf: - type: string - type: 'null' description: >- Empregador atual conforme informado pelo provedor de dados. company_domain: anyOf: - type: string - type: 'null' description: >- Domínio do empregador atual (hostname sem www. ou porta). company_linkedin_url: anyOf: - type: string - type: 'null' description: >- URL da página da empresa do empregador atual no LinkedIn. apollo_match_confidence: anyOf: - type: string - type: 'null' description: >- Confiança do Apollo de que o registro corresponde à entrada: high, medium, low ou none. Nulo para outros provedores de dados. pdl_likelihood: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Pontuação de 1 a 10 da People Data Labs sobre o quanto o registro corresponde à entrada. Nulo para outros provedores de dados. hunter_email_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Confiança de 0 a 100 do Hunter no e-mail (pontuação do email-finder, confiança da pesquisa de domínio). Nulo para outros provedores de dados. zoominfo_accuracy_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Pontuação de 0 a 100 da ZoomInfo sobre a precisão do contato. Nulo para outros provedores de dados. 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: email: anyOf: - type: string - type: 'null' description: Endereço de e-mail retornado pelo provedor de dados. email_status: anyOf: - type: string - type: 'null' description: >- Veredito próprio do provedor de dados sobre a capacidade de entrega. Endereços com status Unknown e catch-all não são endereços verificados como entregáveis. email_catch_all: anyOf: - type: boolean - type: 'null' description: >- Indica se o provedor de dados informa que o domínio é catch-all. email_disposable: anyOf: - type: boolean - type: 'null' description: >- Indica se o provedor de dados informa que o endereço é descartável. email_webmail: anyOf: - type: boolean - type: 'null' description: >- Indica se o provedor de dados informa que o endereço é de um serviço gratuito de webmail. hunter_email_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Pontuação própria de confiança de 0 a 100 do Hunter; nulo para outros provedores de dados. required: - email - email_status - email_catch_all - email_disposable - email_webmail - hunter_email_score additionalProperties: false - type: object properties: name: anyOf: - type: string - type: 'null' description: >- Nome completo exatamente como informado pelo provedor de dados (PDL usa letras minúsculas). Nulo quando o provedor de dados fornece apenas nome e sobrenome; nunca concatenado. first_name: anyOf: - type: string - type: 'null' description: Nome conforme informado pelo provedor de dados. last_name: anyOf: - type: string - type: 'null' description: >- Sobrenome conforme informado pelo provedor de dados. Nulo quando o provedor de dados o mascara (pesquisa do Apollo). job_title: anyOf: - type: string - type: 'null' description: Cargo atual conforme informado pelo provedor de dados. seniority: anyOf: - type: string - type: 'null' description: >- Rótulo de senioridade no vocabulário próprio do provedor de dados que respondeu (Apollo founder, PDL cxo, LeadMagic C-Team, Hunter executive). Não é o vocabulário de seniorities da solicitação e não é comparável entre provedores de dados; verifique provider. Quando o provedor de dados lista vários, o primeiro. department: anyOf: - type: string - type: 'null' description: >- Departamento ou função profissional no vocabulário próprio do provedor de dados que respondeu. Quando o provedor de dados lista vários, o primeiro. headline: anyOf: - type: string - type: 'null' description: Título do perfil (a linha de cargo do LinkedIn). linkedin_url: anyOf: - type: string - type: 'null' description: >- URL do perfil no LinkedIn. https:// é adicionado quando o provedor de dados omite o esquema. city: anyOf: - type: string - type: 'null' description: Cidade da localização da pessoa. region: anyOf: - type: string - type: 'null' description: Estado ou região da localização da pessoa. country: anyOf: - type: string - type: 'null' description: >- País da localização da pessoa como nome de exibição em inglês (nunca um código). country_code: anyOf: - type: string - type: 'null' description: >- País da localização da pessoa como código ISO 3166-1 alpha-2. email: anyOf: - type: string - type: 'null' description: >- E-mail profissional conforme informado pelo provedor de dados. PDL: somente work_email; os demais endereços permanecem no Run. email_status: anyOf: - type: string - type: 'null' description: >- Rótulo próprio de verificação de e-mail do provedor de dados que respondeu (Apollo verified, Prospeo VERIFIED, Hunter e LeadMagic valid). Os provedores de dados verificam de maneiras diferentes, portanto os rótulos não são comparáveis; leia-o com email_catch_all e email_source. email_catch_all: anyOf: - type: boolean - type: 'null' description: >- Verdadeiro quando o provedor de dados informa que o domínio do e-mail aceita todos os endereços, portanto uma verificação de caixa de entrada não pode confirmar este endereço (Hunter accept_all, Apollo email_domain_catchall). email_source: anyOf: - type: string - type: 'null' description: >- Como o Hunter obteve o e-mail: found (encontrado na web) ou generated (gerado a partir do padrão de endereços do domínio). Nulo para outros provedores de dados. phone: anyOf: - type: string - type: 'null' description: >- Número de telefone conforme informado pelo provedor de dados. Números mascarados são omitidos. company_name: anyOf: - type: string - type: 'null' description: >- Empregador atual conforme informado pelo provedor de dados. company_domain: anyOf: - type: string - type: 'null' description: >- Domínio do empregador atual (hostname sem www. ou porta). company_linkedin_url: anyOf: - type: string - type: 'null' description: >- URL da página da empresa do empregador atual no LinkedIn. apollo_match_confidence: anyOf: - type: string - type: 'null' description: >- Confiança do Apollo de que o registro corresponde à entrada: high, medium, low ou none. Nulo para outros provedores de dados. pdl_likelihood: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Pontuação de 1 a 10 da People Data Labs sobre o quanto o registro corresponde à entrada. Nulo para outros provedores de dados. hunter_email_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Grau de confiança de 0 a 100 do Hunter no e-mail (pontuação do email-finder, confiança na pesquisa de domínio). Nulo para outros provedores de dados. zoominfo_accuracy_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Pontuação de precisão de contato de 0 a 100 do ZoomInfo. Nulo para outros provedores de dados. 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: >- Campos normalizados por ação; enrich e find_email retornam uma pessoa com os mesmos campos de uma linha de pesquisa. A saída nativa do provedor de dados não é repetida aqui; ela permanece no Run (GET /v1/runs/:id). Os valores que um provedor de dados não informar serão nulos; uma resposta vazia tem o formato da ação com todos os campos nulos ou items: [], com result_status no_result. Nomes, cargos e rótulos são apresentados como informados pelo provedor de dados. Uma pontuação do próprio modelo de um provedor de dados recebe o nome desse provedor (pdl_likelihood) e é nula para os demais. - 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 - list_employees: 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 - find_phone: 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 - verify_email: email, email_status, email_catch_all, email_disposable, email_webmail, hunter_email_score provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: >- Status HTTP retornado pelo provedor de dados. Verifique-o mesmo quando o Run estiver COMPLETED. error: anyOf: - {} - type: 'null' required: - http_status additionalProperties: false - type: 'null' description: >- Não nulo somente quando o status for COMPLETED. - Para respostas 2xx, output contém o JSON nativo do provedor de dados (qualquer formato) ou null para um corpo vazio. - Para respostas não 2xx, error contém o corpo de erro do provedor de dados e output é null. Os campos confidenciais são removidos de ambos os corpos. charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some usando aritmética decimal ou multiplique por 10^6 — nunca use números de ponto flutuante. - type: 'null' description: >- Cobrança total dos Runs nesta resposta de Solution. Nulo até que todos os Runs listados sejam finalizados. Cada Run mantém sua própria cobrança; falhas também podem ser cobradas. 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: >- Base de cobrança de um único Run ou nulo para um total de vários Runs. Leia runs[].charge_basis para cada cobrança. stoppable: type: boolean description: >- Indica se uma solicitação de parada pode ser aceita no momento. Isso não garante que o Run possa ser interrompido antes do dispatch. stop_requested_at: anyOf: - type: string description: Timestamp UTC no formato ISO-8601 format: date-time - type: 'null' description: >- Quando uma parada foi solicitada. O Run ainda pode continuar se o dispatch já tiver começado. created_at: type: string description: Timestamp UTC no formato ISO-8601 format: date-time started_at: anyOf: - type: string description: Timestamp UTC no formato ISO-8601 format: date-time - type: 'null' completed_at: anyOf: - type: string description: Timestamp UTC no formato ISO-8601 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: >- Seus campos de rastreamento armazenados. Use-os para filtrar Runs. Eles nunca são enviados ao provedor de dados nem afetam o roteamento, o Price ou a idempotência. - Até 20 chaves: letras minúsculas, dígitos e sublinhados; devem começar com uma letra; no máximo 40 caracteres. - Valores: strings de 1 a 500 caracteres. - user_id: o ID opaco do seu usuário final, nunca o endereço de e-mail ou o nome dele. action: type: string enum: - search - list_employees - enrich - find_email - verify_email - find_phone result_status: type: string enum: - success - no_result - error - pending description: >- Status de entrega comercial, independente do ciclo de vida final do Run em status. no_result é uma resposta vazia, mas válida; error significa que a saída do provedor de dados não pôde ser entregue. 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: Abra este Run no console. Requer associação ao Workspace. 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 ou RUNNING: ainda em andamento. COMPLETED: uma resposta do provedor de dados está disponível, incluindo respostas não 2xx. FAILED: consulte `failure`. STOPPED: interrompido antes do dispatch. Leia charge_usd separadamente de status. failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: >- Motivo da falha do Run. Não nulo somente quando o status for 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: >- Status HTTP retornado pelo provedor de dados. Verifique-o mesmo quando o Run estiver 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: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some usando aritmética decimal ou multiplique por 10^6 — nunca use números de ponto flutuante. - type: 'null' description: >- Cobrança final como uma string decimal exata em USD. Nulo enquanto estiver QUEUED ou RUNNING. Um Run FAILED pode ter uma cobrança diferente de zero conforme o Price do endpoint. 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: >- Cláusula de Price usada para calcular a cobrança. Nulo antes da finalização ou quando nenhuma tentativa com o provedor de dados tiver sido feita. stoppable: type: boolean description: >- Indica se uma solicitação de parada pode ser aceita no momento. Isso não garante que o Run possa ser interrompido antes do dispatch. stop_requested_at: anyOf: - type: string description: Timestamp UTC no formato ISO-8601 format: date-time - type: 'null' description: >- Quando uma parada foi solicitada. O Run ainda pode continuar se o dispatch já tiver começado. created_at: type: string description: Timestamp UTC no formato ISO-8601 format: date-time started_at: anyOf: - type: string description: Timestamp UTC no formato ISO-8601 format: date-time - type: 'null' completed_at: anyOf: - type: string description: Timestamp UTC no formato ISO-8601 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: >- Seus campos de rastreamento armazenados. Use-os para filtrar Runs. Eles nunca são enviados ao provedor de dados nem afetam o roteamento, o Price ou a idempotência. - Até 20 chaves: letras minúsculas, dígitos e sublinhados; devem começar com uma letra; no máximo 40 caracteres. - Valores: strings de 1 a 500 caracteres. - user_id: o ID opaco do seu usuário final, nunca o endereço de e-mail ou o nome dele. 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: >- Caminho de URL autenticado e somente leitura para consultar este resultado normalizado e a cobrança total. Use-o com a origem da API. Não cria Runs nem retoma o fallback. GET /v1/runs/:id ainda retorna o Run nativo e individual. 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.