세션 목록 API: KYC·KYB 세션 필터링

curl

curl -s 'https://verification.didit.me/v3/sessions/?status=Approved,In%20Review&date_from=2026-06-01&limit=20' \
  -H 'x-api-key: YOUR_API_KEY'

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

iter := client.Sessions.ListAutoPaging(ctx, didit.SessionsListParams{})
for iter.Next() {
	fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
	log.Fatal(err)
}

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

await foreach (var item in await client.Sessions.ListAsync())
{
    Console.WriteLine(JsonSerializer.Serialize(item));
}

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "session_id": "5b3720ed-d429-42ef-b67f-37ea805f48ee",
      "session_kind": "user",
      "session_number": 720,
      "session_url": "https://verify.didit.me/session/CuXoBYCYVO5Y",
      "portrait_image": "https://<media-host>/portraits/5b3720ed.jpg?X-Amz-Expires=3600&X-Amz-Signature=...",
      "document_type": "Passport",
      "full_name": "Jane Marie Doe",
      "country": "ESP",
      "status": "Approved",
      "vendor_data": "your-user-id-123",
      "didit_internal_id": "d9e78474-6c8d-4f2a-bb90-6f5c2f3a1147",
      "created_at": "2026-06-09T12:26:54.328364Z",
      "features": [
        {
          "feature": "ID_VERIFICATION",
          "status": "Approved"
        },
        {
          "feature": "LIVENESS",
          "status": "Approved"
        },
        {
          "feature": "FACE_MATCH",
          "status": "Approved"
        },
        {
          "feature": "AML",
          "status": "Approved"
        },
        {
          "feature": "IP_ANALYSIS",
          "status": "Approved"
        }
      ],
      "phone_number": {
        "number": "+14155552671",
        "is_verified": true
      },
      "email_address": {
        "email": "jane@example.com",
        "is_verified": true
      },
      "additional_details": {
        "aml": {
          "total_hits": 0,
          "entity_type": "person",
          "is_adverse_media_fetched": false
        },
        "liveness": {
          "method": "PASSIVE",
          "score": 0.98
        },
        "face_match": {
          "score": 0.95
        }
      }
    },
    {
      "session_id": "038ad62f-5ebd-46c2-afe9-4b2956bf687f",
      "session_kind": "user",
      "session_number": 719,
      "session_url": "https://verify.didit.me/session/7RGKiO6ioGH6",
      "portrait_image": null,
      "document_type": null,
      "full_name": null,
      "country": null,
      "status": "Not Started",
      "vendor_data": "your-user-id-124",
      "didit_internal_id": "eb4e679d-ca4b-461f-9685-687bac29ebdb",
      "created_at": "2026-06-09T08:02:23.343053Z",
      "features": [
        {
          "feature": "ID_VERIFICATION",
          "status": "Not Finished"
        },
        {
          "feature": "LIVENESS",
          "status": "Not Finished"
        },
        {
          "feature": "FACE_MATCH",
          "status": "Not Finished"
        },
        {
          "feature": "AML",
          "status": "Not Finished"
        },
        {
          "feature": "IP_ANALYSIS",
          "status": "Not Finished"
        }
      ],
      "phone_number": null,
      "email_address": null,
      "additional_details": null
    }
  ]
}

GET

sessions

curl

curl -s 'https://verification.didit.me/v3/sessions/?status=Approved,In%20Review&date_from=2026-06-01&limit=20' \
  -H 'x-api-key: YOUR_API_KEY'

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

iter := client.Sessions.ListAutoPaging(ctx, didit.SessionsListParams{})
for iter.Next() {
	fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
	log.Fatal(err)
}

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

await foreach (var item in await client.Sessions.ListAsync())
{
    Console.WriteLine(JsonSerializer.Serialize(item));
}

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "session_id": "5b3720ed-d429-42ef-b67f-37ea805f48ee",
      "session_kind": "user",
      "session_number": 720,
      "session_url": "https://verify.didit.me/session/CuXoBYCYVO5Y",
      "portrait_image": "https://<media-host>/portraits/5b3720ed.jpg?X-Amz-Expires=3600&X-Amz-Signature=...",
      "document_type": "Passport",
      "full_name": "Jane Marie Doe",
      "country": "ESP",
      "status": "Approved",
      "vendor_data": "your-user-id-123",
      "didit_internal_id": "d9e78474-6c8d-4f2a-bb90-6f5c2f3a1147",
      "created_at": "2026-06-09T12:26:54.328364Z",
      "features": [
        {
          "feature": "ID_VERIFICATION",
          "status": "Approved"
        },
        {
          "feature": "LIVENESS",
          "status": "Approved"
        },
        {
          "feature": "FACE_MATCH",
          "status": "Approved"
        },
        {
          "feature": "AML",
          "status": "Approved"
        },
        {
          "feature": "IP_ANALYSIS",
          "status": "Approved"
        }
      ],
      "phone_number": {
        "number": "+14155552671",
        "is_verified": true
      },
      "email_address": {
        "email": "jane@example.com",
        "is_verified": true
      },
      "additional_details": {
        "aml": {
          "total_hits": 0,
          "entity_type": "person",
          "is_adverse_media_fetched": false
        },
        "liveness": {
          "method": "PASSIVE",
          "score": 0.98
        },
        "face_match": {
          "score": 0.95
        }
      }
    },
    {
      "session_id": "038ad62f-5ebd-46c2-afe9-4b2956bf687f",
      "session_kind": "user",
      "session_number": 719,
      "session_url": "https://verify.didit.me/session/7RGKiO6ioGH6",
      "portrait_image": null,
      "document_type": null,
      "full_name": null,
      "country": null,
      "status": "Not Started",
      "vendor_data": "your-user-id-124",
      "didit_internal_id": "eb4e679d-ca4b-461f-9685-687bac29ebdb",
      "created_at": "2026-06-09T08:02:23.343053Z",
      "features": [
        {
          "feature": "ID_VERIFICATION",
          "status": "Not Finished"
        },
        {
          "feature": "LIVENESS",
          "status": "Not Finished"
        },
        {
          "feature": "FACE_MATCH",
          "status": "Not Finished"
        },
        {
          "feature": "AML",
          "status": "Not Finished"
        },
        {
          "feature": "IP_ANALYSIS",
          "status": "Not Finished"
        }
      ],
      "phone_number": null,
      "email_address": null,
      "additional_details": null
    }
  ]
}

세션 종류 필터

session_kind 쿼리 파라미터를 사용하면 반환할 세션 종류를 선택할 수 있습니다:

값	반환 내용
`user` (기본값)	사용자 인증(KYC) 세션만 반환합니다. 하위 호환 동작입니다. 이 동작을 원하면 `session_kind`를 생략하세요.
`business`	기업 확인(KYB) 세션만 반환합니다.
`all`	사용자 인증 세션과 기업 확인 세션을 모두 이어 붙여 반환합니다.

응답의 모든 행에는 session_kind: "user" | "business"가 포함되므로, 클라이언트는 행마다 이 값에 따라 응답 형식을 전환할 수 있습니다.

공통 필터

다음 필터는 두 종류 모두에 적용됩니다. 사용자 전용 필터는 session_kind=business일 때 무시되며, 그 반대의 경우도 마찬가지입니다:

쿼리 파라미터	설명
`session_kind`	`user`, `business`, `all` 중 하나입니다. 기본값은 `user`입니다.
`vendor_data`	귀사의 식별자와 정확히 일치하는 값으로 필터링합니다.
`status`	하나 이상의 상태를 쉼표로 구분하여 입력합니다. API가 반환하는 형식 그대로 작성해야 합니다. 예: `Approved`, `Declined`, `In Review` 등(인증 상태 참조).
`workflow_id`	사용된 워크플로로 필터링합니다.
`country`	국가 코드로 필터링합니다(사용자: `issuing_states`, 기업: `country_code`).
`date_from`, `date_to`	생성일 범위입니다(ISO 8601 형식).
`tags`	쉼표로 구분한 태그 ID 목록입니다. 그중 하나라도 해당하는 세션을 반환합니다.
`decided_from`, `decided_to`	ISO 8601 형식의 날짜와 시간입니다. 해당 범위에서 상태가 마지막으로 변경된 세션을 반환합니다(시작 시점 포함, 종료 시점 제외). 생성 시간이 아니라 마지막 상태 변경 시간을 기준으로 합니다.
`search`	화면에 표시되는 전체 참조 값(예: `S-0001`, `B-0001`)을 입력하면 해당 세션 번호와 종류에만 일치합니다. 앞의 0과 대소문자는 무시합니다. 그 외의 입력값은 이름, 연락처, 문서, 등록번호, `vendor_data` 필드를 검색합니다.

예시

사용자 인증(KYC) 세션 목록 (기본값)
기업 확인(KYB) 세션 목록
두 종류 모두 목록 조회

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42"

응답(일부 생략):

{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "session_id": "...",
      "session_kind": "user",
      "session_number": 1024,
      "session_url": "...",
      "portrait_image": "...",
      "document_type": "Passport",
      "full_name": "John Doe",
      "country": "GBR",
      "status": "Approved",
      "vendor_data": "user-42",
      "didit_internal_id": "...",
      "created_at": "2026-04-10T09:00:00Z",
      "features": "ID_VERIFICATION,LIVENESS,FACE_MATCH,AML",
      "phone_number": "+14155550123",
      "email_address": "jane@example.com",
      "additional_details": null
    }
  ]
}

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "session_kind=business" \
  --data-urlencode "status=Approved"

응답(일부 생략):

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "session_id": "...",
      "session_kind": "business",
      "session_number": 89,
      "status": "Approved",
      "vendor_data": "biz-acme-001",
      "created_at": "2026-04-01T09:00:00Z",
      "workflow_id": "wf_kyb_standard",
      "workflow_type": "business",
      "workflow_label": "Standard KYB",
      "company_name": "Acme Corporation Limited",
      "registration_number": "12345678",
      "country": "GBR"
    }
  ]
}

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "session_kind=all" \
  --data-urlencode "date_from=2026-04-01T00:00:00Z"

사용자 인증 행과 기업 확인 행을 하나의 results 배열로 반환합니다. 클라이언트는 session_kind를 기준으로 행마다 처리 방식을 전환해야 합니다.

all 모드는 타임스탬프 순으로 섞지 않고 결과를 단순히 이어 붙입니다. 대량의 혼합 데이터를 순회해야 한다면 종류별로 각각 호출한 뒤 클라이언트에서 병합하세요.

종류별 행 형식 차이

사용자 인증(KYC) 행에는 portrait_image, document_type, full_name, country(발급 국가), phone_number, email_address와 몇 가지 검토 필드가 포함됩니다. 검토 필드는 assignee(세션을 맡고 있는 콘솔 검토자 또는 null), waiting_since와 sla_due_at(세션이 In Review일 때만 설정됨), top_warnings(중요도가 높은 경고 목록이며 각 항목에 risk, feature, log_type, short_description이 포함됨), warnings_count입니다. 기업 확인(KYB) 행에는 workflow_type, workflow_label, company_name, registration_number, country(설립 국가)가 포함됩니다. 두 종류의 행에는 모두 session_id, session_kind, session_number, status, vendor_data, created_at이 포함됩니다. 전체 기능 비교표는 세션 개요를 참조하세요.

페이지네이션

페이지네이션은 limit(기본값 50)과 offset(기본값 0)을 사용하며, 응답에는 절대 URL 형식의 next와 previous URL이 포함됩니다. 두 파라미터는 최대 1000000까지 허용하며, 그보다 큰 값을 보내면 400을 반환합니다. count는 100까지는 정확한 값이며, 그 이상에서는 100으로 고정됩니다. 따라서 전체 개수로 사용하지 마세요. next URL이 null이 될 때까지 계속 요청하세요. session_kind=all을 사용하면 count는 두 종류의 합계이며, 각 종류는 최대 100까지 계산됩니다.

관련 문서

세션 개요
세션 조회: 단일 행의 전체 결정 내용
기업 개요: 여러 세션을 집계한 기업 엔터티
사용자 개요: 여러 세션을 집계한 사용자 엔터티

인증

x-api-key

string

header

필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

쿼리 매개변수

session_kind

enum<string>

기본값:user

조회할 세션의 종류: user(KYC 전용, 기본값), business(KYB 전용), 또는 all(둘 다 결합됨 - 병합된 페이지네이션 시맨틱은 설명 참조). 대소문자를 구분하지 않고 일치하며(BUSINESS도 동작함), user/business/all의 대소문자 변형 이외의 값은 400을 반환합니다.

사용 가능한 옵션:

user,

business,

all

limit

integer

기본값:50

페이지당 최대 행 수(session_kind=all인 경우 종류별)입니다. 기본값은 50입니다.

필수 범위: 1 <= x <= 1000000

offset

integer

기본값:0

반환되는 첫 번째 행 전에 건너뛸 행 수입니다. 기본값은 0입니다. 응답의 next/previous URL을 따르는 것을 권장합니다.

필수 범위: 0 <= x <= 1000000

status

string

포함할 쉼표로 구분된 세션 상태 목록입니다(예: Approved,In Review). 값은 대소문자를 구분합니다. 인증 상태를 참고하십시오. 알 수 없는 값은 아무것도 일치하지 않습니다.

vendor_data

string

세션 생성 시 전송한 vendor_data(자체 사용자/기업 식별자)에 대한 정확한 일치 필터입니다. 부분 일치의 경우 대신 search를 사용하십시오.

string

S-0001(사용자) 또는 B-0001(기업)과 같은 완전한 표시 참조는 해당 세션 번호 및 종류와 정확히 일치할 때만 검색됩니다. 앞자리 0과 대소문자는 일치 여부에 영향을 주지 않습니다. 스마트 자유 텍스트 검색. 전체 UUID는 session_id와 일치합니다. 숫자 입력은 세션 번호 접두사, 문서/개인 식별 번호, 전화번호 접두사 또는 vendor_data와 일치합니다. @가 포함된 입력은 이메일 접두사와 일치합니다. 기타 텍스트는 이름(악센트 미구분) 및 vendor_data와 일치합니다. 숫자가 포함된 자유 텍스트는 문서/개인 식별 번호 검색 필드 및 세션 번호 접두사와도 추가로 일치합니다.

workflow_id

string

쉼표로 구분된 워크플로 UUID 목록입니다(이 UUID는 Console의 Workflows 페이지에서 확인할 수 있습니다). 목록에서 형식이 잘못된 UUID는 무시되며, 유효한 값이 없으면 결과가 비어 있습니다.

date_from

string<date>

이 날짜(UTC) 이후(해당 날짜 포함)에 생성된 세션만 해당하며, 형식은 YYYY-MM-DD입니다. 잘못된 형식의 날짜는 400을 반환합니다.

date_to

string<date>

이 날짜(UTC)까지 생성된 세션만 해당하며, 형식은 YYYY-MM-DD입니다. KYC 행의 경우 당일 전체가 포함되며, KYB 행의 경우 비교 조건이 created_at <= date_to(자정)이므로 KYB 세션의 하루 전체를 포함하려면 다음 날 날짜를 사용하십시오.

응답

페이지네이션된 세션 목록입니다. results 항목은 session_kind에 따라 KYC 행, KYB 행 또는 둘 다일 수 있으며, 각 행의 session_kind 필드로 구분합니다.

count

integer

필수

필터와 일치하는 세션 수: 최대 100개까지는 정확하며 100개를 초과하면 100으로 제한되므로 총계로 사용하지 마십시오. 추가 페이지가 있는지 확인하려면 next를 사용하십시오. session_kind=all의 경우 두 종류의 합계이며, 각각 100으로 제한됩니다.

예시:

2

string<uri> | null

필수

다음 페이지의 절대 URL이며, 마지막 페이지에서는 null입니다.

예시:

"https://verification.didit.me/v3/sessions/?limit=20&offset=20"

string<uri> | null

필수

이전 페이지의 절대 URL이며, 첫 번째 페이지에서는 null입니다.

예시:

null

results

(KYC session row (session_kind: user) · object | KYB session row (session_kind: business) · object)[]

필수

세션 행 목록으로, 최신순으로 정렬됩니다. session_kind=all인 경우 KYC 행이 먼저 표시된 다음 KYB 행이 표시됩니다.

사용자 인증(KYC) 세션의 요약 행입니다. 신원 필드(full_name, country, document_type, portrait_image, 연락처 필드)는 사용자가 인증 단계를 완료함에 따라 점진적으로 채워지며, 관련 단계가 완료될 때까지 null입니다. 워크플로의 응답 속성 설정에 의해 제한된 필드도 null로 반환됩니다.

KYC session row (session_kind: user)
KYB session row (session_kind: business)

Show child attributes

마지막 수정일 2026년 11월 7일

​세션 종류 필터

​공통 필터

​예시

​종류별 행 형식 차이

​페이지네이션

​관련 문서

인증

쿼리 매개변수

응답

세션 종류 필터

공통 필터

예시

종류별 행 형식 차이

페이지네이션

관련 문서