소유 DB 리스트

GET

/api/v1/leads

mohomId별 소유 DB 목록. used 필터( true: 사용완료만, false: 미사용만 ). hasAs=true(또는 Y)면 가장 최근 AS 1건(createdAt 내림차순, 동률 시 id)이 CANCELLED가 아닌 DB만. 마스킹 적용 (사용처리 시 해제). region·gender 필터, search(이름·연락처 끝자리 phone_3·이메일·메모·상품명 부분일치), sortBy(assignedAt|usedAt|age)·sortOrder(asc|desc). assignedAt 정렬은 Lead.lastDistributedAt 기준. 나이순(age)은 생년월일(YYMMDD) 문자열 기준 정렬. 응답 각 항목에 최신 AS 상태 leadAsStatus·leadAsStatusLabel 및(마스킹 전개 시) leadAs 배열이 포함될 수 있음.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Query Params

Responses

🟢200

application/json

DB 목록 및 페이지네이션

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://ldbds.kr/api/v1/leads?mohomId=undefined&used=undefined&hasAs=undefined&region=undefined&gender=undefined&search=undefined&sortBy=undefined&sortOrder=undefined&page=undefined&limit=undefined' \
--header 'X-API-Key: <api-key>'

Response Example

200 - Example 1

{
    "data": [
        {
            "id": "string",
            "productId": "string",
            "product": {
                "id": "string",
                "name": "string"
            },
            "name": "string",
            "phone": "string",
            "email": "string",
            "region": "string",
            "address": "string",
            "birth_date": "string",
            "gender": "string",
            "memo": "string",
            "assignmentId": "string",
            "usedAt": "2019-08-24T14:15:22.123Z",
            "assignedAt": "2019-08-24T14:15:22.123Z",
            "lastDistributedAt": "2019-08-24T14:15:22.123Z",
            "metadata": null,
            "leadAs": [
                {
                    "status": "string"
                }
            ],
            "leadAsStatus": "string",
            "leadAsStatusLabel": "string"
        }
    ],
    "pagination": {
        "page": 0,
        "limit": 0,
        "total": 0,
        "totalPages": 0
    }
}

Modified at 2026-06-29 09:24:45

주문 취소

DB 단건 등록