POST Account Inquiry

HTTPS Request

[Production] POST https://partner.rem.id/api/account-inquiry

[Staging] POST https://api-demo.rem.id/api/account-inquiry

‍

Header Parameters

Parameter	Type	Required	Description
x-username	String	True	Username for authentication Example: `yourusername`
x-api-key	String	True	API key for authentication Example: `your-api-key`

‍

Request Parameters

Parameter	Type	Required	Description
bank_code	String(255)	TRUE	Bank Code of the Beneficiary account, see Disbursement Bank Codes
account_number	String(255)	TRUE	Beneficiary account number, numeric only

‍

Response Parameters

Parameter	Type	Description
status	Object	Status of inquiry `{code: <status_code>, message: <status_message>}`
bank_code	String	Bank Code of the Beneficiary account, see Disbursement Bank Codes
account_number	String	Account Number of the Beneficiary Account
account_name	String	Account Name of the Beneficiary Account
id	String	Unique ID of the inquiry. ID will be provided only for `000` or `209` status. Otherwise, the ID will be `null`.
invoice_id	String	ID of the invoice related to the inquiry result.
timestamp	Timestamp	UTC Timestamp api hit (Format: `yyyy-MM-ddTHH:mm:ss`)

‍

{
  "bank_code": "002",
  "account_number": "200531000000017985"
}
curl --location 'https://{host}/api/account-inquiry' \
--header 'x-username: yourusername' \
--header 'x-api-key: your-api-key' \
--header 'Content-Type: application/json' \
--data '{
  "bank_code": "002",
  "account_number": "200531000000017985"
}'
Request Samples

    
    
  
000
{
  "status": {
    "code": "000",
    "message": "Success"
  },
  "bank_code": "008",
  "account_number": "12341234",
  "account_name": "John Doe",
  "timestamp": "2025-03-11T06:33:18",
  "id": "747bf914-eb0c-4a59-adcb-b8a151f56b17",
  "invoice_id": "3d440813-26be-4d78-9177-3ad30b4268fe"
}
205
{
  "status": {
    "code": "205",
    "message": "Bank Code is not found"
  },
  "bank_code": "INVALID",
  "account_number": "12341234",
  "account_name": null,
  "timestamp": "2025-03-11T06:21:36",
  "id": null,
  "invoice_id": null
}
209
{
  "status": {
    "code": "209",
    "message": "Bank Account is not found"
  },
  "bank_code": "008",
  "account_number": "12341234",
  "account_name": null,
  "timestamp": "2025-08-03T12:00:02",
  "id": "715078ea-8699-452d-94ac-e9c909190924",
  "invoice_id": "98c1099e-9763-46a1-b6a1-8f32ff179525"
}
500
{
  "status": {
    "code": "500",
    "message": "Internal server error"
  }
}
Response Samples

Get Details of Account Inquiry Invoice by ID

Use this API to get inquiry invoice by ID.

‍

HTTPS Request

[Production] GET https://partner.rem.id/api/account-inquiry/invoices/<invoiceId>

[Staging] GET https://api-demo.rem.id/api/account-inquiry/invoices/<invoiceId>

‍

Header Parameters

Parameter	Type	Required	Description
x-username	String	True	Username for authentication Example: `yourusername`
x-api-key	String	True	API key for authentication Example: `your-api-key`

https://{host}/api/account-inquiry/invoices/bf76fa75-e19c-4edd-8d44-a5a0fa454fac

curl --location 'https://{host}/api/account-inquiry/invoices/bf76fa75-e19c-4edd-8d44-a5a0fa454fac' \
--header 'x-username: yourusername' \
--header 'x-api-key: your-api-key'

Request Samples

000

{
  "status": {
    "code": "000",
    "message": "Success"
  },
  "invoice_id": "bf76fa75-e19c-4edd-8d44-a5a0fa454fac",
  "tx_date": "2025-03-11",
  "amount": 2000,
  "total_inquiry": 2,
  "paid_at": null,
  "invoice_status": "INITIATED",
  "due_at": "2025-03-11T17:00:00",
  "timestamp": "2025-03-11T06:50:50"
}

204

{
  "status": {
    "code": "204",
    "message": "Invoice ID not found"
  },
  "invoice_id": null,
  "tx_date": null,
  "amount": null,
  "total_inquiry": 0,
  "paid_at": null,
  "invoice_status": null,
  "due_at": null,
  "timestamp": "2025-08-03T12:01:25"
}

500

{
  "status": {
    "code": "500",
    "message": "Internal server error"
  }
}

Response Samples

Get List of Account Inquiry Invoices

Use this API to get inquiry invoices.

‍

HTTPS Request

[Production] GET https://partner.rem.id/api/account-inquiry/invoices?offset=<offset>&limit=<limit>&status=<status>

[Staging] GET https://api-demo.rem.id/api/account-inquiry/invoices?offset=<offset>&limit=<limit>&status=<status>

‍

Query Parameters

Parameter	Type	Description
offset	Integer	start offset, default is 0, if empty will used default value
limit	Integer	max item to fetch, default is 10, if empty will used default value
status	String	invoice status to fetch. If empty will fetch invoice regardless of the status Enum: `INITIATED`, `UNPAID`, `PAID`

Header Parameters

Parameter	Type	Required	Description
x-username	String	True	Username for authentication Example: `yourusername`
x-api-key	String	True	API key for authentication Example: `your-api-key`

https://{host}/api/account-inquiry/invoices?offset=0&limit=10&status=

curl --location 'https://{host}/api/account-inquiry/invoices?limit=10&offset=0&status=PAID' \
--header 'x-username: yourusername' \
--header 'x-api-key: your-api-key'

Request Samples

000

{
  "total": 3,
  "status": {
    "code": "000",
    "message": "Success"
  },
  "data": [
    {
      "invoice_id": "715f3e75-b4f0-4a12-83ba-6271d6b37e5d",
      "tx_date": "2025-04-22",
      "amount": 1000,
      "total_inquiry": 1,
      "paid_at": "2025-04-23T08:45:01",
      "invoice_status": "PAID",
      "due_at": "2025-04-22T17:00:00"
    },
    {
      "invoice_id": "1767b79b-0468-4c09-a905-d6fdcbb040a1",
      "tx_date": "2025-04-17",
      "amount": 1000,
      "total_inquiry": 1,
      "paid_at": "2025-04-18T08:45:01",
      "invoice_status": "PAID",
      "due_at": "2025-04-17T17:00:00"
    },
    {
      "invoice_id": "93ec1afe-6538-4ced-ab59-12449bbd1b69",
      "tx_date": "2025-03-26",
      "amount": 2000,
      "total_inquiry": 2,
      "paid_at": "2025-03-27T08:45:04",
      "invoice_status": "PAID",
      "due_at": "2025-03-26T17:00:00"
    }
  ],
  "timestamp": "2025-05-26T15:23:25"
}

201

{
  "total": 0,
  "status": {
    "code": "201",
    "message": "User is not found"
  },
  "data": [],
  "timestamp": "2025-08-03T12:03:33"
}

500

{
  "status": {
    "code": "500",
    "message": "Internal server error"
  }
}

Response Samples

Pay Account Inquiry Invoice

Use this API to pay inquiry invoice.

‍

HTTPS Request

[Production] POST https://partner.rem.id/api/account-inquiry/invoices/pay

[Staging] POST https://api-demo.rem.id/api/account-inquiry/invoices/pay

‍

Header Parameters

Parameter	Type	Required	Description
x-username	String	True	Username for authentication Example: `yourusername`
x-api-key	String	True	API key for authentication Example: `your-api-key`

‍

Request Parameters

Parameter	Type	Required	Description
invoice_id	String	TRUE	Invoice ID

‍

Response Parameters

Parameter	Type	Description
status	Object	Status of inquiry `{code: <status_code>, message: <status_message>}`
invoice_id	String	invoice ID
tx_date	String	the UTC+7 date of inquiry transaction from 00:00 UTC+7 until 23:59 UTC+7
amount	String	amount of the invoice
total_inquiry	Integer	the number of inquiries
paid_at	String	UTC invoice payment timestamp
invoice_status	String	status of the invoice: `INITIATED`, `UNPAID`, or `PAID`
due_at	String	UTC due timestamp for the invoice

{"invoice_id": "bf76fa75-e19c-4edd-8d44-a5a0fa454fac"}

curl --location 'https://{host}/api/account-inquiry' \
--header 'x-username: yourusername' \
--header 'x-api-key: your-api-key' \
--header 'Content-Type: application/json' \
--data '{
  "invoice_id": "bf76fa75-e19c-4edd-8d44-a5a0fa454fac"
}'

‍

Request Samples

102

{
  "status": {
    "code": "102",
    "message": "Request is In progress"
  },
  "invoice_id": "bf76fa75-e19c-4edd-8d44-a5a0fa454fac",
  "tx_date": "2025-03-10",
  "amount": 1000,
  "total_inquiry": 1,
  "paid_at": null,
  "due_at": "2025-03-10T17:00:00",
  "invoice_status": "UNPAID",
  "timestamp": "2025-03-12T07:07:15"
}

204

{
  "status": {
    "code": "204",
    "message": "Invoice ID not found."
  },
  "invoice_id": "YOUR-INVOICE-ID",
  "tx_date": null,
  "amount": null,
  "total_inquiry": 0,
  "paid_at": null,
  "due_at": null,
  "invoice_status": null,
  "timestamp": "2025-08-03T12:04:28"
}

500

{
  "status": {
    "code": "500",
    "message": "Internal server error"
  }
}

Response Samples