문서 / 문서 조회

문서 조회

GET/documents

GET/documents/:id

GET/documents/received

/documents 는 이 워크스페이스가 보낸 문서를, /documents/received 는 내 이메일이 서명자로 들어간 문서를 돌려줍니다. 상세에는 서명자별 상태와 진행 이력이 함께 들어 있습니다.

문서 상태

status	뜻
`draft`	만들어졌지만 아직 보내지 않음
`sent`	발송됨. 서명을 기다리는 중
`completed`	전원 서명 완료. 완료본과 인증서가 만들어짐
`rejected`	서명자가 거절해 종료. 건수 환불됨
`canceled`	요청자가 취소. 건수 환불됨
`expired`	기한이 지나 만료

서명자 상태

status	뜻
`pending`	아직 통지 전(순차 서명에서 차례가 오지 않음)
`notified`	링크를 보냈고 아직 열지 않음
`viewed`	문서를 열어 봤음
`signed`	서명을 마침
`rejected`	거절함

서명 링크 토큰(signToken)은 API 로 나가지 않습니다. 토큰을 쥐면 누구나 그 사람 대신 서명할 수 있기 때문입니다. 서명자에게는 우리가 보낸 메일·문자 링크로만 전달됩니다.

이전대량 발송 다음재발송과 취소

더 궁금한 점이 있나요?

콘솔 사용법은 사용자 가이드를 보세요. 연동 중 막히면 hello@lillo.cx 로 요청·응답을 함께 보내 주세요.

문서 상세

bash

curl https://api.pindersign.net/v1/documents/8f2a… \
  -H "Authorization: Bearer psk_xxxxxxxx"

응답

json

{
  "id": "8f2a…",
  "title": "2026년 프리랜서 용역계약서",
  "status": "completed",
  "pageCount": 3,
  "sentAt": "2026-09-15T10:02:00.000Z",
  "completedAt": "2026-09-15T13:02:13.227Z",
  "verificationKey": "9490bc44…",
  "participants": [
    { "order": 1, "name": "김하늘",
      "contact": "haneul@partner.co",
      "status": "signed",
      "signedAt": "2026-09-15T13:02:00.000Z" }
  ],
  "events": [
    { "type": "viewed", "actorName": "김하늘",
      "ip": "203.0.113.7",
      "message": "… 문서의 내용을 확인했어요.",
      "createdAt": "2026-09-15T12:40:00.000Z" }
  ]
}