v1

latestOpenAPI 3.1.02026-07-263847150.4 KB

Get Presigned URLs

Get presigned URLs for you to upload required documents based on the submissionType. After successful uploads, call the Confirm Upload API to start processing.

get/esign-partner/v1/submissions/urls

Query parameters

submissionType'CERT_REG' required

Submission type for certificate registration

Headers

x-onekyc-tokenstring required

IAB Partner token generated using the Get Partner Token API

x-esign-onboarding-partnerstring required

Used to identify the source of the request (generated by OneKYC team)

x-partner-user-idstring required

User ID of the current session. IAB will tie this info to the resulting submission ID.

x-partner-user-id-typestring required

Detailed name of the User ID. IAB will tie this info to the resulting submission ID.

x-partner-session-idstring uuid required

Session ID of the current session (generated by partner) that can be used as a correlation ID. Should be uniquely generated for each invocation. Acts as idempotency ID between Partner BE and IAB BE.

Response

Successful presigned URL generation

successboolean

Example response

{
  "success": true,
  "data": {
    "status": "INITIATED",
    "documents": {
      "KTP": {
        "documentUrl": "https://al-ky-id-s-esign-service.oss-ap-southeast-5.aliyuncs.com/CERT_REG/5e021eb4-d875-47bb-817b-8b1782f0c3bb_SELFIE?X-Amz-Security-Token=CAIS2QJ1q6Ft5B2yfSjIr5qGIPziqKpwxZuhMVbXsWoCadtn3I%2FzhTz2IHhMfHhsBO0Wsv0ymGFY5v8ZlrF0TZJGVEeBdchrq80IrlP4ONqe45TusOdcIEJ%2B4ODIWXDBx8b3T7jTbrG0I4WACT3tkit03sGJF1GLVECkNpukkINuas9tMCCzcTtBAqU9RGIg0rh4U0HcLvGwKBXnr3PNBU5zwGpGhHh49L60z7%2F3iHOcriWnk7VL996gc8P6MJI8YsshabrvgrwmJpim%2BTVL9h1H%2BJ1xiKF54jrdtrmfeQIJu03Xb7eJooE2cVMoNvhjQLQ5oeP9mvs9oeHJiYX8xlNEJfkQXD%2FfVD5KeEodqgbI3L8bAlWbUxylurjnXhL14xI4yxkQfYXGL2%2BrztOklfiAbnC7TOHusRvhOTzIMIP%2Bi7otmrEOtG7D5rfkaibJLfz3vihwpGvXWx1AX3YagAEc9cDzjyTiGa4217on4KanvDDLEM4S4R1v%2F7i0SSRVa8c4LTrGA28YjM3dv3e%2BYTVLzunP0PT7e8T5JSstO0Mhoi127g2u2ahJRxYrPEfGlOk6NycJNS345QM1k%2BKwVBetpUwWDNf8nosT16O2KjykrmXq66XrGmg6oiKKTUFmHiAA&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20260507T110754Z&X-Amz-SignedHeaders=host&X-Amz-Credential=LTAI5tK86mktEnBbhjUrMadp%2F20260507%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Expires=432000&X-Amz-Signature=9580cba19e5929c2a250eef3f5637571478d27142444bcf33a3fa53c34938884",
        "documentReference": "d4b9ddd1-8193-4291-82c9-a0bf72982b86_SELFIE",
        "expiryInSeconds": "432000"
      },
      "SELFIE": {
        "documentUrl": "https://al-ky-id-s-esign-service.oss-ap-southeast-5.aliyuncs.com/CERT_REG/5e021eb4-d875-47bb-817b-8b1782f0c3bb_SELFIE?X-Amz-Security-Token=CAIS2QJ1q6Ft5B2yfSjIr5qGIPziqKpwxZuhMVbXsWoCadtn3I%2FzhTz2IHhMfHhsBO0Wsv0ymGFY5v8ZlrF0TZJGVEeBdchrq80IrlP4ONqe45TusOdcIEJ%2B4ODIWXDBx8b3T7jTbrG0I4WACT3tkit03sGJF1GLVECkNpukkINuas9tMCCzcTtBAqU9RGIg0rh4U0HcLvGwKBXnr3PNBU5zwGpGhHh49L60z7%2F3iHOcriWnk7VL996gc8P6MJI8YsshabrvgrwmJpim%2BTVL9h1H%2BJ1xiKF54jrdtrmfeQIJu03Xb7eJooE2cVMoNvhjQLQ5oeP9mvs9oeHJiYX8xlNEJfkQXD%2FfVD5KeEodqgbI3L8bAlWbUxylurjnXhL14xI4yxkQfYXGL2%2BrztOklfiAbnC7TOHusRvhOTzIMIP%2Bi7otmrEOtG7D5rfkaibJLfz3vihwpGvXWx1AX3YagAEc9cDzjyTiGa4217on4KanvDDLEM4S4R1v%2F7i0SSRVa8c4LTrGA28YjM3dv3e%2BYTVLzunP0PT7e8T5JSstO0Mhoi127g2u2ahJRxYrPEfGlOk6NycJNS345QM1k%2BKwVBetpUwWDNf8nosT16O2KjykrmXq66XrGmg6oiKKTUFmHiAA&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20260507T110754Z&X-Amz-SignedHeaders=host&X-Amz-Credential=LTAI5tK86mktEnBbhjUrMadp%2F20260507%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Expires=432000&X-Amz-Signature=9580cba19e5929c2a250eef3f5637571478d27142444bcf33a3fa53c34938884",
        "documentReference": "d4b9ddd1-8193-4291-82c9-a0bf72982b86_SELFIE",
        "expiryInSeconds": "432000"
      }
    }
  }
}