> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Estado do serviço Didit: API de estado público

> GET /v3/status/ é um feed público e sem autenticação com o estado de cada serviço Didit e 7 dias de incidentes, para widgets e verificações.



Prompt do estado dos serviços
        Copiar o prompt para a área de transferência



      
      

\<pre>

\`Read Didit's public service status feed.

GET https://verification.didit.me/v3/status/

Auth: NONE. Send no auth header.

Success (HTTP 200):
\- status: worst state of any service right now: "operational" | "degraded" | "down"
\- updated_at: ISO 8601 time Didit built the response (up to 30 seconds old)
\- services[]: one { key, name, status } per service. Match on key, never on name. Keys:
service_id_verification, service_liveness_face_match, service_aml_screening, service_kyb_registries,
service_database_validation, service_phone_delivery, service_email_delivery, service_transaction_monitoring
\- incidents[]: newest started_at first. Every ongoing incident plus those resolved in the last 7 days (at most 50 resolved). Each:
\{ id, service, service_name, state ("degraded" | "down"), status ("ongoing" | "resolved"), title, body,
affected, country_name, started_at, resolved_at (null while ongoing), duration_minutes (null while ongoing) }
\- title and body are English. To translate, build your own text from service, state and country_name.

Cadence: responses are cached for 30 seconds. Poll no more than once every 30 seconds.

curl -fsS https://verification.didit.me/v3/status/

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.`

\</pre>



      
      

Colar em

## Visão geralDevolve o estado de todos os serviços da Didit, o estado geral e os incidentes em curso ou resolvidos nos últimos 7 dias.
O endpoint é público: não envie nenhum cabeçalho de autenticação.
A resposta não contém dados da organização e é a mesma para todos os chamadores.## Quando usar- **Widget de estado**: mostre aos seus utilizadores ou à sua equipa de suporte se um serviço da Didit está degradado neste momento.
- **Verificação de estado da integração**: antes de atribuir a culpa ao seu próprio código por verificações lentas ou com falhas, veja se a Didit reporta um incidente no serviço que está a chamar.
- **Histórico de incidentes**: liste o que aconteceu nos últimos 7 dias e quanto tempo durou cada incidente.Para verificar apenas se a API está acessível, use o [healthcheck](https://docs.didit.me/pt/api-reference/healthcheck.md).## Consultas periódicasAs respostas ficam em cache durante 30 segundos, por isso faça consultas no máximo uma vez a cada 30 segundos.
`updated_at` indica quando a Didit gerou a resposta que recebeu.
Aplica-se também um limite de pedidos GET de 600 por minuto por endereço IP.## Serviços`services` lista todos os serviços, tenham ou não um incidente.
Faça a correspondência pelo `key`: `name` é um nome de apresentação em inglês e pode mudar.| `key` | Serviço |
| - | - |
| `service_id_verification` | Verificação de identidade |
| `service_liveness_face_match` | Prova de vida e correspondência facial |
| `service_aml_screening` | Triagem AML |
| `service_kyb_registries` | Registos KYB |
| `service_database_validation` | Validação de base de dados |
| `service_phone_delivery` | Entrega da verificação de telefone |
| `service_email_delivery` | Entrega da verificação de e-mail |
| `service_transaction_monitoring` | Monitorização de transações |O `status` de cada serviço é `operational`, `degraded` ou `down`.
É `operational` quando o serviço não tem nenhum incidente em curso; caso contrário, é o pior estado dos seus incidentes em curso.
O `status` de nível superior é o pior estado de todos os serviços.## Incidentes`incidents` lista todos os incidentes em curso e os incidentes resolvidos nos últimos 7 dias, do `started_at` mais recente para o mais antigo.
São listados no máximo 50 incidentes resolvidos.- `state` é `degraded` ou `down`. Um incidente resolvido mantém o último estado que teve.
- `status` é `ongoing` até o serviço recuperar, e depois passa a `resolved`.
- `resolved_at` e `duration_minutes` são `null` enquanto o incidente estiver em curso.
- `affected` e `country_name` indicam o país ou registo afetado, por exemplo `Brazil (CPF)` e `Brazil`. Ficam vazios quando o incidente não está associado a um país ou registo.
- `title` e `body` estão em inglês. Para mostrar o incidente noutro idioma, crie o seu próprio texto a partir de `service`, `state` e `country_name`.## Exemplo de resposta```json theme={null}
{
  "status": "degraded",
  "updated_at": "2026-10-13T09:41:07.512345Z",
  "services": [
    { "key": "service_id_verification", "name": "ID verification", "status": "operational" },
    { "key": "service_liveness_face_match", "name": "Liveness and face match", "status": "operational" },
    { "key": "service_aml_screening", "name": "AML screening", "status": "operational" },
    { "key": "service_kyb_registries", "name": "KYB registries", "status": "operational" },
    { "key": "service_database_validation", "name": "Database validation", "status": "degraded" },
    { "key": "service_phone_delivery", "name": "Phone verification delivery", "status": "operational" },
    { "key": "service_email_delivery", "name": "Email verification delivery", "status": "operational" },
    { "key": "service_transaction_monitoring", "name": "Transaction monitoring", "status": "operational" }
  ],
  "incidents": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "service": "service_database_validation",
      "service_name": "Database validation",
      "state": "degraded",
      "status": "ongoing",
      "title": "Database validation is degraded in Brazil.",
      "body": "Checks against Brazil (CPF) may be slow or fail since 08:55 UTC.",
      "affected": "Brazil (CPF)",
      "country_name": "Brazil",
      "started_at": "2026-10-13T08:55:00Z",
      "resolved_at": null,
      "duration_minutes": null
    },
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "service": "service_aml_screening",
      "service_name": "AML screening",
      "state": "down",
      "status": "resolved",
      "title": "AML screening is back to normal.",
      "body": "Recovered at 14:32 UTC after 17 minutes.",
      "affected": "",
      "country_name": "",
      "started_at": "2026-10-11T14:15:00Z",
      "resolved_at": "2026-10-11T14:32:00Z",
      "duration_minutes": 17
    }
  ]
}
```## Ver também- [Healthcheck](https://docs.didit.me/pt/api-reference/healthcheck.md): uma sonda de disponibilidade pública que também não requer nenhum cabeçalho de autenticação.
- [Webhooks de alerta](https://docs.didit.me/pt/integration/alert-webhooks.md): receba `alert.service.degraded` e `alert.service.recovered` no seu endpoint, para os serviços usados pela sua organização.
- [Limites de pedidos](https://docs.didit.me/pt/integration/rate-limiting.md)


## OpenAPI

````yaml pt/openapi-25.json GET /v3/status/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API de Verificação de identidade. Autentique-se com o cabeçalho x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/status/:
    get:
      tags:
        - Status
      summary: Obter estado do serviço (público, não autenticado)
      description: >-
        Devolve o estado de cada serviço Didit (`operational`, `degraded` ou
        `down`), o estado global (o pior de entre eles) e os incidentes em curso
        ou resolvidos nos últimos 7 dias. Utilize-o para alimentar um widget de
        estado ou para verificar o estado da Didit a partir da sua integração.


        Público: não envie cabeçalho de autenticação. A resposta não contém
        dados da organização e é igual para todos os autores de chamadas. As
        respostas ficam em cache durante 30 segundos, pelo que não deve
        consultar mais do que uma vez a cada 30 segundos.
      operationId: get_v3_status
      parameters: []
      responses:
        '200':
          description: Estado atual do serviço.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceStatusFeed'
              examples:
                One service degraded:
                  summary: Um incidente em curso e um resolvido esta semana
                  value:
                    status: degraded
                    updated_at: '2026-10-13T09:41:07.512345Z'
                    services:
                      - key: service_id_verification
                        name: ID verification
                        status: operational
                      - key: service_liveness_face_match
                        name: Liveness and face match
                        status: operational
                      - key: service_aml_screening
                        name: AML screening
                        status: operational
                      - key: service_kyb_registries
                        name: KYB registries
                        status: operational
                      - key: service_database_validation
                        name: Database validation
                        status: degraded
                      - key: service_phone_delivery
                        name: Phone verification delivery
                        status: operational
                      - key: service_email_delivery
                        name: Email verification delivery
                        status: operational
                      - key: service_transaction_monitoring
                        name: Transaction monitoring
                        status: operational
                    incidents:
                      - id: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                        service: service_database_validation
                        service_name: Database validation
                        state: degraded
                        status: ongoing
                        title: Database validation is degraded in Brazil.
                        body: >-
                          Checks against Brazil (CPF) may be slow or fail since
                          08:55 UTC.
                        affected: Brazil (CPF)
                        country_name: Brazil
                        started_at: '2026-10-13T08:55:00Z'
                        resolved_at: null
                        duration_minutes: null
                      - id: 7c9e6679-7425-40de-944b-e07fc1f90ae7
                        service: service_aml_screening
                        service_name: AML screening
                        state: down
                        status: resolved
                        title: AML screening is back to normal.
                        body: Recovered at 14:32 UTC after 17 minutes.
                        affected: ''
                        country_name: ''
                        started_at: '2026-10-11T14:15:00Z'
                        resolved_at: '2026-10-11T14:32:00Z'
                        duration_minutes: 17
                All operational:
                  summary: Nenhum incidente nos últimos 7 dias
                  value:
                    status: operational
                    updated_at: '2026-10-13T09:41:07.512345Z'
                    services:
                      - key: service_id_verification
                        name: ID verification
                        status: operational
                      - key: service_liveness_face_match
                        name: Liveness and face match
                        status: operational
                      - key: service_aml_screening
                        name: AML screening
                        status: operational
                      - key: service_kyb_registries
                        name: KYB registries
                        status: operational
                      - key: service_database_validation
                        name: Database validation
                        status: operational
                      - key: service_phone_delivery
                        name: Phone verification delivery
                        status: operational
                      - key: service_email_delivery
                        name: Email verification delivery
                        status: operational
                      - key: service_transaction_monitoring
                        name: Transaction monitoring
                        status: operational
                    incidents: []
        '429':
          description: >-
            Mais de 600 pedidos GET num minuto a partir do mesmo endereço IP (ou
            da mesma chave de API, caso envie uma). Respeite o cabeçalho
            `Retry-After` antes de tentar novamente.
          content:
            application/json:
              schema:
                type: object
                required:
                  - detail
                properties:
                  detail:
                    type: string
              example:
                detail: >-
                  GET request rate limit exceeded. You can make up to 600
                  requests per minute.
      security:
        - {}
      x-codeSamples:
        - lang: curl
          label: curl
          source: curl -fsS https://verification.didit.me/v3/status/
        - lang: python
          label: Python
          source: >-
            import requests


            resp = requests.get('https://verification.didit.me/v3/status/',
            timeout=5)

            resp.raise_for_status()

            feed = resp.json()

            print(feed['status'])

            for service in feed['services']:
                if service['status'] != 'operational':
                    print(service['key'], service['status'])
        - lang: javascript
          label: JavaScript
          source: >-
            const feed = await
            fetch('https://verification.didit.me/v3/status/').then((r) =>
            r.json());

            console.log(feed.status);

            const affected = feed.services.filter((s) => s.status !==
            'operational');

            console.log(affected.map((s) => `${s.key}: ${s.status}`));
components:
  schemas:
    ServiceStatusFeed:
      type: object
      description: >-
        Estado público do serviço: o estado de cada serviço Didit, o estado
        global e os incidentes que estão em curso ou foram resolvidos nos
        últimos 7 dias.
      required:
        - status
        - updated_at
        - services
        - incidents
      properties:
        status:
          type: string
          enum:
            - operational
            - degraded
            - down
          description: >-
            O pior estado de qualquer serviço neste momento, determinado apenas
            pelos incidentes em curso.
          example: degraded
        updated_at:
          type: string
          format: date-time
          description: >-
            Quando a Didit construiu esta resposta (ISO 8601, UTC). As respostas
            são guardadas em cache durante 30 segundos, pelo que podem ter até
            30 segundos de antiguidade.
          example: '2026-10-13T09:41:07.512345Z'
        services:
          type: array
          description: Uma entrada por serviço, com todos os serviços sempre listados.
          items:
            $ref: '#/components/schemas/ServiceStatusService'
        incidents:
          type: array
          description: >-
            `started_at` mais recente primeiro. Todos os incidentes em curso,
            mais os incidentes resolvidos nos últimos 7 dias (no máximo 50
            incidentes resolvidos). Vazio quando nada aconteceu nesse período.
          items:
            $ref: '#/components/schemas/ServiceStatusIncident'
    ServiceStatusService:
      type: object
      required:
        - key
        - name
        - status
      properties:
        key:
          type: string
          enum:
            - service_id_verification
            - service_liveness_face_match
            - service_aml_screening
            - service_kyb_registries
            - service_database_validation
            - service_phone_delivery
            - service_email_delivery
            - service_transaction_monitoring
          description: >-
            Chave de serviço estável. Efetue a correspondência com base neste
            campo, nunca pelo nome de exibição. `service_id_verification`:
            Verificação de identidade, `service_liveness_face_match`: Prova de
            vida e correspondência facial, `service_aml_screening`: Triagem AML,
            `service_kyb_registries`: Registos KYB,
            `service_database_validation`: Validação de base de dados,
            `service_phone_delivery`: Entrega de verificação de telefone,
            `service_email_delivery`: Entrega de verificação de e-mail,
            `service_transaction_monitoring`: Monitorização de transações.
          example: service_database_validation
        name:
          type: string
          description: Nome de apresentação em inglês do serviço.
          example: Database validation
        status:
          type: string
          enum:
            - operational
            - degraded
            - down
          description: >-
            `operational` quando não há incidentes em curso para o serviço; caso
            contrário, o pior estado dos seus incidentes em curso.
          example: degraded
    ServiceStatusIncident:
      type: object
      required:
        - id
        - service
        - service_name
        - state
        - status
        - title
        - body
        - affected
        - country_name
        - started_at
        - resolved_at
        - duration_minutes
      properties:
        id:
          type: string
          format: uuid
          description: ID do incidente.
          example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
        service:
          type: string
          enum:
            - service_id_verification
            - service_liveness_face_match
            - service_aml_screening
            - service_kyb_registries
            - service_database_validation
            - service_phone_delivery
            - service_email_delivery
            - service_transaction_monitoring
          description: Chave do serviço afetado (consulte `services[].key`).
          example: service_database_validation
        service_name:
          type: string
          description: Nome de apresentação em inglês do serviço afetado.
          example: Database validation
        state:
          type: string
          enum:
            - degraded
            - down
          description: >-
            Como o serviço é afetado. Um incidente resolvido mantém o último
            estado em que se encontrava.
          example: degraded
        status:
          type: string
          enum:
            - ongoing
            - resolved
          description: '`ongoing` até que o serviço recupere, depois `resolved`.'
          example: ongoing
        title:
          type: string
          description: >-
            Título em inglês. Para o traduzir, construa o seu próprio texto a
            partir de `service`, `state` e `country_name`.
          example: Database validation is degraded in Brazil.
        body:
          type: string
          description: >-
            Linha de detalhe em inglês: desde quando as verificações podem estar
            lentas ou falhar, ou quando recuperou.
          example: Checks against Brazil (CPF) may be slow or fail since 08:55 UTC.
        affected:
          type: string
          description: >-
            Países ou registos afetados, por exemplo `Brazil (CPF)`. Vazio
            quando o incidente não está associado a um país ou registo.
          example: Brazil (CPF)
        country_name:
          type: string
          description: >-
            País afetado, em inglês. Vazio quando o incidente não está associado
            a um país.
          example: Brazil
        started_at:
          type: string
          format: date-time
          description: Quando o incidente começou (ISO 8601, UTC).
          example: '2026-10-13T08:55:00Z'
        resolved_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Quando o serviço recuperou (ISO 8601, UTC). `null` enquanto o
            incidente estiver em curso.
        duration_minutes:
          type: integer
          nullable: true
          description: >-
            Minutos inteiros desde `started_at` até `resolved_at`. `null`
            enquanto o incidente estiver em curso.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.