{
"info": {
"_postman_id": "71c510b6-1a39-45c2-a990-c9349845eef8",
"name": "Contracts Plus For Banks",
"description": "### Contracts Plus Data Inquiry Service is an API that enables you to integrate and obtain existing and historical contract data related to Government Tenders and Procurements. The API service allows the beneficiaries to inquire via Commercial Registry No. (CR) without the contract number. The API includes basic contract and beneficiary data. \n\n#### To see the error messages and the valid response :\n | Response Status Code | Contract Number | Id Type | Id Value |\n | ---------------------| ----------------| --------|---------------|\n | **200** | 191201000575 | 01 |1000000001 |\n \n
More information about authorization can be found in the Token API integration guide:'\n",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
"_exporter_id": "47100298",
"_collection_link": "https://rehamalmutiri-4180031.postman.co/workspace/15944b1e-b16d-4441-8b30-4304c956348c/collection/47100298-71c510b6-1a39-45c2-a990-c9349845eef8?action=share&source=collection_link&creator=47100298"
},
"item": [
{
"name": "sandbox",
"item": [
{
"name": "banking",
"item": [
{
"name": "v1",
"item": [
{
"name": "contracts",
"item": [
{
"name": "/sandbox/banking/v1/contracts",
"request": {
"auth": {
"type": "oauth2",
"oauth2": [
{
"key": "clientSecret",
"value": "{{clientSecret}}",
"type": "string"
},
{
"key": "clientId",
"value": "{{clientID}}",
"type": "string"
},
{
"key": "accessTokenUrl",
"value": "{{baseUrl}}/sandbox/oauth/v2/accesstoken",
"type": "string"
},
{
"key": "scope",
"value": "ReadBanksContracts",
"type": "string"
},
{
"key": "X_MOF_ClientID",
"value": "{{clientID}}",
"type": "string"
},
{
"key": "grant_type",
"value": "client_credentials",
"type": "string"
}
]
},
"method": "GET",
"header": [
{
"key": "X_MOF_RqUID",
"value": "{{$guid}}",
"description": "(Required) Request UID, it is unique reference, GUID format"
},
{
"key": "X_MOF_ClientID",
"value": "{{clientID}}",
"description": "(Required) Client Id of Banks or fintech companies"
},
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/sandbox/banking/v1/contracts?contractNumber=191201000575&idType=01&idValue=1000000001&sortBy=contractStartDate&sortOrder=DESC&limit=10&offset=2",
"host": [
"{{baseUrl}}"
],
"path": [
"sandbox",
"banking",
"v1",
"contracts"
],
"query": [
{
"key": "contractNumber",
"value": "191201000575",
"description": "Contract Number"
},
{
"key": "idType",
"value": "01",
"description": "(Required) Vendor identification type and allowed values are: 01 means the value of idValue parameter is *CR* of vendor, 02 means *beneficiaryId*, and 03 means *700Id*\n"
},
{
"key": "idValue",
"value": "1000000001",
"description": "(Required) Vendor identification value of selected Id type"
},
{
"key": "sortBy",
"value": "contractStartDate",
"description": "Sort by amount or contractStartDate or contractEndDate
\n"
},
{
"key": "sortOrder",
"value": "DESC",
"description": "Sorting order"
},
{
"key": "limit",
"value": "10",
"description": "(Required) Total number of contracts for each page"
},
{
"key": "offset",
"value": "2",
"description": "(Required) Page number"
}
]
}
},
"response": [
{
"name": "Ok",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "X_MOF_RqUID",
"value": "{{$guid}}",
"description": "(Required) Request UID, it is unique reference, GUID format"
},
{
"key": "X_MOF_ClientID",
"value": "{{clientID}}",
"description": "(Required) Client Id of Banks or fintech companies"
},
{
"key": "Accept",
"value": "application/json"
},
{
"key": "Authorization",
"value": "",
"description": "Added as a part of security scheme: oauth2"
}
],
"url": {
"raw": "{{baseUrl}}/sandbox/banking/v1/contracts?contractNumber=191201000575&idType=01&idValue=1000000001&sortBy=contractStartDate&sortOrder=DESC&limit=10&offset=2",
"host": [
"{{baseUrl}}"
],
"path": [
"sandbox",
"banking",
"v1",
"contracts"
],
"query": [
{
"key": "contractNumber",
"value": "191201000575",
"description": "Contract Number"
},
{
"key": "idType",
"value": "01",
"description": "(Required) Vendor identification type and allowed values are: 01 means the value of idValue parameter is *CR* of vendor, 02 means *beneficiaryId*, and 03 means *700Id*\n"
},
{
"key": "idValue",
"value": "1000000001",
"description": "(Required) Vendor identification value of selected Id type"
},
{
"key": "sortBy",
"value": "contractStartDate",
"description": "Sort by amount or contractStartDate or contractEndDate
\n"
},
{
"key": "sortOrder",
"value": "DESC",
"description": "Sorting order"
},
{
"key": "limit",
"value": "10",
"description": "(Required) Total number of contracts for each page"
},
{
"key": "offset",
"value": "2",
"description": "(Required) Page number"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"body": "{\n \"meta\": {\n \"totalRecords\": 12,\n \"limit\": 1,\n \"offset\": 2,\n \"next\": \"/banking/v1/contracts?offset=3&limit=1\",\n \"previous\": \"/banking/v1/contracts?offset=1&limit=1\"\n },\n \"data\": [\n {\n \"name\": \"Test for Bank\",\n \"referenceNumber\": \"123456789123\",\n \"govAgency\": {\n \"agencyName\": \" مدينة الملك فهد الطبية\",\n \"agencyCode\": \"022001000003\"\n },\n \"amount\": 5748.497070122229,\n \"vendors\": [\n {\n \"name\": \"شركة مؤسسة محمد سعيد فهّاد للدعاية والإعلان\",\n \"CRNumber\": \"1000000001\",\n \"isMainVendor\": true\n },\n {\n \"name\": \"شركة مؤسسة محمد سعيد فهّاد للدعاية والإعلان\",\n \"CRNumber\": \"1000000001\",\n \"isMainVendor\": false\n }\n ],\n \"totalReleasedAmount\": 8632.074329287942,\n \"duration\": {\n \"startDate\": \"2021-07-14\",\n \"endDate\": \"2022-07-14\"\n },\n \"financialClaims\": [\n {\n \"referenceNumber\": \"111111111111\",\n \"amount\": 9526.768981975447,\n \"status\": \"ملغي\"\n },\n {\n \"referenceNumber\": \"111111111111\",\n \"amount\": 4873.336762116413,\n \"status\": \"معتمد\"\n }\n ],\n \"paymentOrders\": {\n \"bankName\": \"مصرف الراجحى\",\n \"accountNumber\": \"SA9494030800899994888403\",\n \"paymentOrderDate\": \"2022-12-01\"\n }\n },\n {\n \"name\": \"Test for Bank\",\n \"referenceNumber\": \"123456789123\",\n \"govAgency\": {\n \"agencyName\": \" مدينة الملك فهد الطبية\",\n \"agencyCode\": \"022001000003\"\n },\n \"amount\": 4213.3478505698595,\n \"vendors\": [\n {\n \"name\": \"شركة مؤسسة محمد سعيد فهّاد للدعاية والإعلان\",\n \"CRNumber\": \"1000000001\",\n \"isMainVendor\": true\n },\n {\n \"name\": \"شركة مؤسسة محمد سعيد فهّاد للدعاية والإعلان\",\n \"CRNumber\": \"1000000001\",\n \"isMainVendor\": false\n }\n ],\n \"totalReleasedAmount\": 5217.224667883338,\n \"duration\": {\n \"startDate\": \"2021-07-14\",\n \"endDate\": \"2022-07-14\"\n },\n \"financialClaims\": [\n {\n \"referenceNumber\": \"111111111111\",\n \"amount\": 8155.881691168598,\n \"status\": \"تحت الاجراء\"\n },\n {\n \"referenceNumber\": \"111111111111\",\n \"amount\": 8410.868620573083,\n \"status\": \"معتمد\"\n }\n ],\n \"paymentOrders\": {\n \"bankName\": \"مصرف الراجحى\",\n \"accountNumber\": \"SA9494030800899994888403\",\n \"paymentOrderDate\": \"2022-12-01\"\n }\n }\n ]\n}"
},
{
"name": "A",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "X_MOF_RqUID",
"value": "{{$guid}}",
"description": "(Required) Request UID, it is unique reference, GUID format"
},
{
"key": "X_MOF_ClientID",
"value": "{{clientID}}",
"description": "(Required) Client Id of Banks or fintech companies"
},
{
"key": "Accept",
"value": "application/json"
},
{
"key": "Authorization",
"value": "",
"description": "Added as a part of security scheme: oauth2"
}
],
"url": {
"raw": "{{baseUrl}}/sandbox/banking/v1/contracts?contractNumber=191201000575&idType=01&idValue=1000000001&sortBy=contractStartDate&sortOrder=DESC&limit=10&offset=2",
"host": [
"{{baseUrl}}"
],
"path": [
"sandbox",
"banking",
"v1",
"contracts"
],
"query": [
{
"key": "contractNumber",
"value": "191201000575",
"description": "Contract Number"
},
{
"key": "idType",
"value": "01",
"description": "(Required) Vendor identification type and allowed values are: 01 means the value of idValue parameter is *CR* of vendor, 02 means *beneficiaryId*, and 03 means *700Id*\n"
},
{
"key": "idValue",
"value": "1000000001",
"description": "(Required) Vendor identification value of selected Id type"
},
{
"key": "sortBy",
"value": "contractStartDate",
"description": "Sort by amount or contractStartDate or contractEndDate
\n"
},
{
"key": "sortOrder",
"value": "DESC",
"description": "Sorting order"
},
{
"key": "limit",
"value": "10",
"description": "(Required) Total number of contracts for each page"
},
{
"key": "offset",
"value": "2",
"description": "(Required) Page number"
}
]
}
},
"status": "Bad Request",
"code": 400,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"body": "{\n \"code\": \"A001400,\",\n \"details\": \"Some Required Fields are not founded in your request, Please return to documentation,\",\n \"type\": \"BusinessError,\",\n \"link\": null,\n \"in\": [\n {\n \"name\": \"idValue\",\n \"type\": \"query\"\n }\n ]\n}"
},
{
"name": "B",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "X_MOF_RqUID",
"value": "{{$guid}}",
"description": "(Required) Request UID, it is unique reference, GUID format"
},
{
"key": "X_MOF_ClientID",
"value": "{{clientID}}",
"description": "(Required) Client Id of Banks or fintech companies"
},
{
"key": "Accept",
"value": "application/json"
},
{
"key": "Authorization",
"value": "",
"description": "Added as a part of security scheme: oauth2"
}
],
"url": {
"raw": "{{baseUrl}}/sandbox/banking/v1/contracts?contractNumber=191201000575&idType=01&idValue=1000000001&sortBy=contractStartDate&sortOrder=DESC&limit=10&offset=2",
"host": [
"{{baseUrl}}"
],
"path": [
"sandbox",
"banking",
"v1",
"contracts"
],
"query": [
{
"key": "contractNumber",
"value": "191201000575",
"description": "Contract Number"
},
{
"key": "idType",
"value": "01",
"description": "(Required) Vendor identification type and allowed values are: 01 means the value of idValue parameter is *CR* of vendor, 02 means *beneficiaryId*, and 03 means *700Id*\n"
},
{
"key": "idValue",
"value": "1000000001",
"description": "(Required) Vendor identification value of selected Id type"
},
{
"key": "sortBy",
"value": "contractStartDate",
"description": "Sort by amount or contractStartDate or contractEndDate
\n"
},
{
"key": "sortOrder",
"value": "DESC",
"description": "Sorting order"
},
{
"key": "limit",
"value": "10",
"description": "(Required) Total number of contracts for each page"
},
{
"key": "offset",
"value": "2",
"description": "(Required) Page number"
}
]
}
},
"status": "Bad Request",
"code": 400,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"body": "{\n \"code\": \"A002400,\",\n \"details\": \"Validation format failed. Please return to documentations.,\",\n \"type\": \"BusinessError,\",\n \"link\": null,\n \"in\": [\n {\n \"name\": \"idValue\",\n \"type\": \"query\",\n \"reason\": \"Invalid white space character\"\n }\n ]\n}"
},
{
"name": "Unauthorized",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "X_MOF_RqUID",
"value": "{{$guid}}",
"description": "(Required) Request UID, it is unique reference, GUID format"
},
{
"key": "X_MOF_ClientID",
"value": "{{clientID}}",
"description": "(Required) Client Id of Banks or fintech companies"
},
{
"key": "Authorization",
"value": "",
"description": "Added as a part of security scheme: oauth2"
}
],
"url": {
"raw": "{{baseUrl}}/sandbox/banking/v1/contracts?contractNumber=191201000575&idType=01&idValue=1000000001&sortBy=contractStartDate&sortOrder=DESC&limit=10&offset=2",
"host": [
"{{baseUrl}}"
],
"path": [
"sandbox",
"banking",
"v1",
"contracts"
],
"query": [
{
"key": "contractNumber",
"value": "191201000575",
"description": "Contract Number"
},
{
"key": "idType",
"value": "01",
"description": "(Required) Vendor identification type and allowed values are: 01 means the value of idValue parameter is *CR* of vendor, 02 means *beneficiaryId*, and 03 means *700Id*\n"
},
{
"key": "idValue",
"value": "1000000001",
"description": "(Required) Vendor identification value of selected Id type"
},
{
"key": "sortBy",
"value": "contractStartDate",
"description": "Sort by amount or contractStartDate or contractEndDate
\n"
},
{
"key": "sortOrder",
"value": "DESC",
"description": "Sorting order"
},
{
"key": "limit",
"value": "10",
"description": "(Required) Total number of contracts for each page"
},
{
"key": "offset",
"value": "2",
"description": "(Required) Page number"
}
]
}
},
"status": "Unauthorized",
"code": 401,
"_postman_previewlanguage": "text",
"header": [],
"cookie": [],
"body": ""
},
{
"name": "Forbidden",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "X_MOF_RqUID",
"value": "{{$guid}}",
"description": "(Required) Request UID, it is unique reference, GUID format"
},
{
"key": "X_MOF_ClientID",
"value": "{{clientID}}",
"description": "(Required) Client Id of Banks or fintech companies"
},
{
"key": "Accept",
"value": "application/json"
},
{
"key": "Authorization",
"value": "",
"description": "Added as a part of security scheme: oauth2"
}
],
"url": {
"raw": "{{baseUrl}}/sandbox/banking/v1/contracts?contractNumber=191201000575&idType=01&idValue=1000000001&sortBy=contractStartDate&sortOrder=DESC&limit=10&offset=2",
"host": [
"{{baseUrl}}"
],
"path": [
"sandbox",
"banking",
"v1",
"contracts"
],
"query": [
{
"key": "contractNumber",
"value": "191201000575",
"description": "Contract Number"
},
{
"key": "idType",
"value": "01",
"description": "(Required) Vendor identification type and allowed values are: 01 means the value of idValue parameter is *CR* of vendor, 02 means *beneficiaryId*, and 03 means *700Id*\n"
},
{
"key": "idValue",
"value": "1000000001",
"description": "(Required) Vendor identification value of selected Id type"
},
{
"key": "sortBy",
"value": "contractStartDate",
"description": "Sort by amount or contractStartDate or contractEndDate
\n"
},
{
"key": "sortOrder",
"value": "DESC",
"description": "Sorting order"
},
{
"key": "limit",
"value": "10",
"description": "(Required) Total number of contracts for each page"
},
{
"key": "offset",
"value": "2",
"description": "(Required) Page number"
}
]
}
},
"status": "Forbidden",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"body": "{\n \"errors\": [\n {\n \"code\": \"A001403\",\n \"details\": \"Error Message Detail\",\n \"type\": \"BusinessError\",\n \"link\": \"afiwYKXjPSUvhkngnKqe.ey\"\n },\n {\n \"code\": \"A001403\",\n \"details\": \"Error Message Detail\",\n \"type\": \"BusinessError\",\n \"link\": \"TwBnmGOSuTtVwphdeZTcqIdKn.hzk\"\n }\n ]\n}"
},
{
"name": "Not Found",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "X_MOF_RqUID",
"value": "{{$guid}}",
"description": "(Required) Request UID, it is unique reference, GUID format"
},
{
"key": "X_MOF_ClientID",
"value": "{{clientID}}",
"description": "(Required) Client Id of Banks or fintech companies"
},
{
"key": "Accept",
"value": "application/json"
},
{
"key": "Authorization",
"value": "",
"description": "Added as a part of security scheme: oauth2"
}
],
"url": {
"raw": "{{baseUrl}}/sandbox/banking/v1/contracts?contractNumber=191201000575&idType=01&idValue=1000000001&sortBy=contractStartDate&sortOrder=DESC&limit=10&offset=2",
"host": [
"{{baseUrl}}"
],
"path": [
"sandbox",
"banking",
"v1",
"contracts"
],
"query": [
{
"key": "contractNumber",
"value": "191201000575",
"description": "Contract Number"
},
{
"key": "idType",
"value": "01",
"description": "(Required) Vendor identification type and allowed values are: 01 means the value of idValue parameter is *CR* of vendor, 02 means *beneficiaryId*, and 03 means *700Id*\n"
},
{
"key": "idValue",
"value": "1000000001",
"description": "(Required) Vendor identification value of selected Id type"
},
{
"key": "sortBy",
"value": "contractStartDate",
"description": "Sort by amount or contractStartDate or contractEndDate
\n"
},
{
"key": "sortOrder",
"value": "DESC",
"description": "Sorting order"
},
{
"key": "limit",
"value": "10",
"description": "(Required) Total number of contracts for each page"
},
{
"key": "offset",
"value": "2",
"description": "(Required) Page number"
}
]
}
},
"status": "Not Found",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"body": "{\n \"errors\": [\n {\n \"code\": \"A001404\",\n \"details\": \"contract not found\",\n \"type\": \"BusinessError\",\n \"link\": \"dHKq.olrg\"\n },\n {\n \"code\": \"A001404\",\n \"details\": \"contract not found\",\n \"type\": \"BusinessError\",\n \"link\": \"vcGX.cz\"\n }\n ]\n}"
},
{
"name": "Backend Timeout",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "X_MOF_RqUID",
"value": "{{$guid}}",
"description": "(Required) Request UID, it is unique reference, GUID format"
},
{
"key": "X_MOF_ClientID",
"value": "{{clientID}}",
"description": "(Required) Client Id of Banks or fintech companies"
},
{
"key": "Authorization",
"value": "",
"description": "Added as a part of security scheme: oauth2"
}
],
"url": {
"raw": "{{baseUrl}}/sandbox/banking/v1/contracts?contractNumber=191201000575&idType=01&idValue=1000000001&sortBy=contractStartDate&sortOrder=DESC&limit=10&offset=2",
"host": [
"{{baseUrl}}"
],
"path": [
"sandbox",
"banking",
"v1",
"contracts"
],
"query": [
{
"key": "contractNumber",
"value": "191201000575",
"description": "Contract Number"
},
{
"key": "idType",
"value": "01",
"description": "(Required) Vendor identification type and allowed values are: 01 means the value of idValue parameter is *CR* of vendor, 02 means *beneficiaryId*, and 03 means *700Id*\n"
},
{
"key": "idValue",
"value": "1000000001",
"description": "(Required) Vendor identification value of selected Id type"
},
{
"key": "sortBy",
"value": "contractStartDate",
"description": "Sort by amount or contractStartDate or contractEndDate
\n"
},
{
"key": "sortOrder",
"value": "DESC",
"description": "Sorting order"
},
{
"key": "limit",
"value": "10",
"description": "(Required) Total number of contracts for each page"
},
{
"key": "offset",
"value": "2",
"description": "(Required) Page number"
}
]
}
},
"status": "Request Timeout",
"code": 408,
"_postman_previewlanguage": "text",
"header": [],
"cookie": [],
"body": ""
},
{
"name": "Internal Server Error",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "X_MOF_RqUID",
"value": "{{$guid}}",
"description": "(Required) Request UID, it is unique reference, GUID format"
},
{
"key": "X_MOF_ClientID",
"value": "{{clientID}}",
"description": "(Required) Client Id of Banks or fintech companies"
},
{
"key": "Accept",
"value": "application/json"
},
{
"key": "Authorization",
"value": "",
"description": "Added as a part of security scheme: oauth2"
}
],
"url": {
"raw": "{{baseUrl}}/sandbox/banking/v1/contracts?contractNumber=191201000575&idType=01&idValue=1000000001&sortBy=contractStartDate&sortOrder=DESC&limit=10&offset=2",
"host": [
"{{baseUrl}}"
],
"path": [
"sandbox",
"banking",
"v1",
"contracts"
],
"query": [
{
"key": "contractNumber",
"value": "191201000575",
"description": "Contract Number"
},
{
"key": "idType",
"value": "01",
"description": "(Required) Vendor identification type and allowed values are: 01 means the value of idValue parameter is *CR* of vendor, 02 means *beneficiaryId*, and 03 means *700Id*\n"
},
{
"key": "idValue",
"value": "1000000001",
"description": "(Required) Vendor identification value of selected Id type"
},
{
"key": "sortBy",
"value": "contractStartDate",
"description": "Sort by amount or contractStartDate or contractEndDate
\n"
},
{
"key": "sortOrder",
"value": "DESC",
"description": "Sorting order"
},
{
"key": "limit",
"value": "10",
"description": "(Required) Total number of contracts for each page"
},
{
"key": "offset",
"value": "2",
"description": "(Required) Page number"
}
]
}
},
"status": "Internal Server Error",
"code": 500,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"body": "{\n \"errors\": [\n {\n \"code\": \"A001500\",\n \"details\": \"Internal Server Error\",\n \"type\": \"BusinessError\",\n \"link\": \"DeWDgxomYyuXYHYCBaLlvfGXnOgVXsbK.wef\"\n },\n {\n \"code\": \"A001500\",\n \"details\": \"Internal Server Error\",\n \"type\": \"BusinessError\",\n \"link\": \"OYpDgrhkEMmqcKpsGnLxYEbvh.uv\"\n }\n ]\n}"
}
]
}
]
}
]
}
]
}
]
}
],
"auth": {
"type": "oauth2",
"oauth2": [
{
"key": "scope",
"value": "ReadBanksContracts",
"type": "string"
},
{
"key": "accessTokenUrl",
"value": "{{baseUrl}}/sandbox/oauth/v2/accesstoken",
"type": "string"
},
{
"key": "X_MOF_ClientID",
"value": "{{clientID}}",
"type": "string"
},
{
"key": "grant_type",
"value": "client_credentials",
"type": "string"
}
]
},
"variable": [
{
"key": "baseUrl",
"value": "https://sandboxapi.etimad.sa"
},
{
"key": "clientID",
"value": "JRZgTE5h1zRxpiYMFpv85VgdvMoEGGcN"
},
{
"key": "clientSecret",
"value": "2nDfAXilPMrfW70v"
}
]
}