> ## 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.

# 서비스 상태 API: Didit 공개 상태 피드

> GET /v3/status/은 인증 없이 호출할 수 있는 공개 피드로, Didit 각 서비스의 상태와 최근 7일간의 장애 내역을 제공합니다. 상태 위젯과 상태 점검에 활용하세요.



서비스 상태 프롬프트
        프롬프트를 클립보드에 복사



      
      

\<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>



      
      

붙여넣을 곳

## 개요모든 Didit 서비스의 상태, 전체 상태, 그리고 현재 진행 중이거나 지난 7일 안에 해결된 인시던트를 반환합니다.
이 endpoint는 공개되어 있으므로 인증 헤더를 보내지 않습니다.
응답에는 조직 데이터가 포함되지 않으며, 호출하는 모든 클라이언트에 대해 동일합니다.## 사용 시기- **상태 위젯**: 사용자나 지원팀에 Didit 서비스가 지금 성능 저하 상태인지 보여 줍니다.
- **연동 상태 확인**: 자체 코드의 확인 요청이 느리거나 실패할 때 원인을 자신의 코드에서 찾기 전에, 호출하는 서비스에 대해 Didit이 인시던트를 보고했는지 확인합니다.
- **인시던트 기록**: 지난 7일 동안 발생한 사건과 각 인시던트가 지속된 시간을 나열합니다.API에 접근할 수 있는지만 확인하려면 대신 [헬스체크](https://docs.didit.me/ko/api-reference/healthcheck.md)를 사용합니다.## 폴링응답은 30초 동안 캐시되므로, 30초에 한 번보다 자주 폴링하지 마십시오.
`updated_at`은 수신한 응답을 Didit이 생성한 시점을 알려 줍니다.
또한 주소당 분당 600회의 GET 속도 제한이 적용됩니다.## 서비스`services`에는 인시던트 유무와 관계없이 모든 서비스가 나열됩니다.
`key`를 기준으로 매칭하십시오. `name`은 영어 표시 이름이며 변경될 수 있습니다.| `key` | 서비스 |
| - | - |
| `service_id_verification` | 신분증 인증 |
| `service_liveness_face_match` | 라이브니스 감지 및 얼굴 대조 |
| `service_aml_screening` | AML 스크리닝 |
| `service_kyb_registries` | KYB 법인 등기부 |
| `service_database_validation` | 데이터베이스 검증 |
| `service_phone_delivery` | 전화번호 인증 전송 |
| `service_email_delivery` | 이메일 인증 전송 |
| `service_transaction_monitoring` | 거래 모니터링 |각 서비스의 `status`는 `operational`, `degraded` 또는 `down`입니다.
서비스에 진행 중인 인시던트가 없으면 `operational`이며, 그렇지 않으면 진행 중인 인시던트 중 가장 심각한 상태가 됩니다.
최상위 `status`는 모든 서비스 중 가장 심각한 상태입니다.## 인시던트`incidents`에는 진행 중인 모든 인시던트와 지난 7일 안에 해결된 인시던트가 나열되며, `started_at`이 가장 최근인 항목이 먼저 옵니다.
해결된 인시던트는 최대 50건까지 나열됩니다.- `state`는 `degraded` 또는 `down`입니다. 해결된 인시던트는 마지막으로 가졌던 상태를 유지합니다.
- `status`는 서비스가 복구되기 전까지 `ongoing`이며, 복구된 후에는 `resolved`입니다.
- `resolved_at`과 `duration_minutes`는 인시던트가 진행 중인 동안 `null`입니다.
- `affected`와 `country_name`은 영향을 받은 국가나 등록부를 나타냅니다. 예를 들어 `Brazil (CPF)`와 `Brazil`이 있습니다. 인시던트가 특정 국가나 등록부와 관련이 없으면 비어 있습니다.
- `title`과 `body`는 영어입니다. 다른 언어로 인시던트를 보여 주려면 `service`, `state`, `country_name`을 바탕으로 자체 텍스트를 구성하십시오.## 응답 예시```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
    }
  ]
}
```## 관련 문서- [헬스체크](https://docs.didit.me/ko/api-reference/healthcheck.md): 공개 라이브니스 프로브이며, 이 역시 인증 헤더가 필요하지 않습니다.
- [알림 webhook](https://docs.didit.me/ko/integration/alert-webhooks.md): 조직이 사용하는 서비스에 대해 `alert.service.degraded`와 `alert.service.recovered` 이벤트를 endpoint로 전달받습니다.
- [속도 제한](https://docs.didit.me/ko/integration/rate-limiting.md)


## OpenAPI

````yaml ko/openapi-25.json GET /v3/status/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: 신분증 인증 API입니다. x-api-key 헤더로 인증합니다.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/status/:
    get:
      tags:
        - Status
      summary: 서비스 상태 가져오기(공개, 인증 불필요)
      description: >-
        각 Didit 서비스의 상태(`operational`, `degraded` 또는 `down`), 전체 상태(가장 심각한 상태),
        그리고 진행 중이거나 지난 7일 이내에 해결된 인시던트를 반환합니다. 상태 위젯을 구동하거나 연동 환경에서 Didit의 상태를
        확인하는 데 사용하십시오.


        공개: 인증 헤더를 전송하지 마십시오. 응답에는 조직 데이터가 포함되지 않으며 모든 호출자에게 동일합니다. 응답은 30초 동안
        캐시되므로 30초에 한 번 이하로 폴링하십시오.
      operationId: get_v3_status
      parameters: []
      responses:
        '200':
          description: 현재 서비스 상태입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceStatusFeed'
              examples:
                One service degraded:
                  summary: 진행 중인 장애 1건 및 이번 주에 해결된 장애 1건
                  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: 지난 7일간 인시던트 없음
                  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: >-
            동일한 IP 주소(또는 전달한 경우 동일한 API 키)에서 1분 동안 600건을 초과하는 GET 요청이 발생했습니다. 다시
            시도하기 전에 `Retry-After`를 준수하세요.
          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: '공개 서비스 상태: 각 Didit 서비스의 상태, 전체 상태 및 진행 중이거나 지난 7일 동안 해결된 인시던트입니다.'
      required:
        - status
        - updated_at
        - services
        - incidents
      properties:
        status:
          type: string
          enum:
            - operational
            - degraded
            - down
          description: 진행 중인 인시던트만을 기준으로 판단한 현재 모든 서비스 중 가장 심각한 상태입니다.
          example: degraded
        updated_at:
          type: string
          format: date-time
          description: >-
            Didit이 이 응답을 생성한 시점(ISO 8601, UTC)입니다. 응답은 30초 동안 캐시되므로 최대 30초 전의
            데이터일 수 있습니다.
          example: '2026-10-13T09:41:07.512345Z'
        services:
          type: array
          description: 서비스당 항목 1개이며, 모든 서비스가 항상 나열됩니다.
          items:
            $ref: '#/components/schemas/ServiceStatusService'
        incidents:
          type: array
          description: >-
            최신 `started_at` 순입니다. 진행 중인 모든 인시던트와 최근 7일 동안 해결된 인시던트(최대 50개의 해결된
            인시던트)를 포함합니다. 해당 기간 동안 발생한 일이 없으면 비어 있습니다.
          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: >-
            고정 서비스 키입니다. 표시 이름이 아닌 이 키와 일치시켜야 합니다. `service_id_verification`:
            신분증 인증, `service_liveness_face_match`: 라이브니스 및 얼굴 대조,
            `service_aml_screening`: AML 스크리닝, `service_kyb_registries`: KYB
            레지스트리, `service_database_validation`: 데이터베이스 검증,
            `service_phone_delivery`: 전화번호 인증 전송, `service_email_delivery`: 이메일
            인증 전송, `service_transaction_monitoring`: 거래 모니터링.
          example: service_database_validation
        name:
          type: string
          description: 서비스의 영어 표시 이름입니다.
          example: Database validation
        status:
          type: string
          enum:
            - operational
            - degraded
            - down
          description: >-
            서비스에 진행 중인 인시던트가 없으면 `operational`이며, 그렇지 않으면 진행 중인 인시던트 중 가장 심각한
            상태가 표시됩니다.
          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입니다.
          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: 영향을 받는 서비스의 키입니다(`services[].key` 참조).
          example: service_database_validation
        service_name:
          type: string
          description: 영향을 받는 서비스의 영어 표시 이름입니다.
          example: Database validation
        state:
          type: string
          enum:
            - degraded
            - down
          description: 서비스가 영향을 받는 방식입니다. 해결된 인시던트는 마지막 상태를 유지합니다.
          example: degraded
        status:
          type: string
          enum:
            - ongoing
            - resolved
          description: 서비스가 복구될 때까지 `ongoing`이며, 복구되면 `resolved`입니다.
          example: ongoing
        title:
          type: string
          description: >-
            영어 헤드라인입니다. 번역하려면 `service`, `state`, `country_name`을 사용하여 자체 텍스트를
            구성하세요.
          example: Database validation is degraded in Brazil.
        body:
          type: string
          description: '영어 세부 정보 문구: 검사가 지연되거나 실패할 수 있게 된 시점 또는 복구된 시점입니다.'
          example: Checks against Brazil (CPF) may be slow or fail since 08:55 UTC.
        affected:
          type: string
          description: >-
            영향을 받는 국가 또는 등기소입니다(예: `Brazil (CPF)`). 인시던트가 특정 국가 또는 등기소와 연관되지 않은
            경우 비어 있습니다.
          example: Brazil (CPF)
        country_name:
          type: string
          description: 영향을 받는 국가(영문)입니다. 인시던트가 특정 국가와 연관되지 않은 경우 비어 있습니다.
          example: Brazil
        started_at:
          type: string
          format: date-time
          description: 인시던트가 시작된 시점(ISO 8601, UTC).
          example: '2026-10-13T08:55:00Z'
        resolved_at:
          type: string
          format: date-time
          nullable: true
          description: 서비스가 복구된 시점(ISO 8601, UTC). 인시던트가 진행 중인 동안에는 `null`입니다.
        duration_minutes:
          type: integer
          nullable: true
          description: >-
            `started_at`부터 `resolved_at`까지의 정수(분) 단위 시간입니다. 인시던트가 진행 중인 동안에는
            `null`입니다.

````

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