Entrevistas

Obter uma entrevista por ID

Retorna uma única entrevista com exatamente o mesmo formato de cada item da listagem (GET /appointments/job-talent/{jobTalentId}). Útil quando você já tem o appointmentId (vindo de um link, evento, lista anterior) e não quer fazer query por jobTalentId.

Diferença em relação à listagem: quando a entrevista não existe, este endpoint retorna 404. A listagem por jobTalentId retorna 200 com [].

get/appointments/{appointmentId}

Request

  • Base URL: https://api.inhire.app
  • URL: https://api.inhire.app/appointments/{appointmentId}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-api-key

Path parameters

appointmentIdstring required

ID do appointment (formato apt_<ulid>).

Response

Appointment encontrado.

appointmentIdstring required

ID do entrevista — usar nos endpoints de detalhe e transcript.

namestring required

Título do evento.

status'scheduled' | 'cancelled' | 'deleted' | 'done' | 'not_happened' required

Estado atual do entrevista.

startDateTimestring date-time required

Início do evento (ISO 8601).

endDateTimestring date-time required

Fim do evento (ISO 8601).

provider'google' | 'outlook' | 'manual' required

Provedor do calendário onde o evento foi criado.

callLinkstring nullable

Link da reunião quando houver (Meet/Teams/etc.).

Example response

{
  "appointmentId": "apt_01HABCDEF...",
  "name": "Entrevista técnica — João Silva",
  "status": "done",
  "startDateTime": "2026-05-20T14:00:00.000Z",
  "endDateTime": "2026-05-20T15:00:00.000Z",
  "provider": "google",
  "callLink": "https://meet.google.com/abc-defg-hij",
  "transcription": {
    "status": "COMPLETED",
    "provider": "google-meet",
    "summary": "Discussão sobre experiência em React e arquitetura de microserviços.",
    "participants": [
      {
        "id": "joao-silva",
        "name": "João Silva",
        "email": "joao@exemplo.com"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.