Submit for review
const url = 'https://sandbox.partners.loops.sa/v1/merchant/business-profile/submit';const options = { method: 'POST', headers: { 'Loops-Merchant-Id': 'mer_7Hq2Lw8Z', 'Idempotency-Key': '6f1c2a9e-3b7d-4c55-9a40-2d8e1f7b9c31', Authorization: 'Bearer <token>' }};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://sandbox.partners.loops.sa/v1/merchant/business-profile/submit \ --header 'Authorization: Bearer <token>' \ --header 'Idempotency-Key: 6f1c2a9e-3b7d-4c55-9a40-2d8e1f7b9c31' \ --header 'Loops-Merchant-Id: mer_7Hq2Lw8Z'Sends the business profile to Loops for review. All required details and every type in
required_documents must be present, otherwise you get 400 invalid_request listing
what is missing. The status becomes in_review, and you receive
business_profile.approved or business_profile.rejected when Loops decides.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Header Parameters
Section titled “Header Parameters”The merchant you are acting for (mer_…). Required for platform applications;
optional for direct integrations, which have a single merchant.
A unique value (a UUID) for this request. If you retry with the same key within 24 hours, you get the original response instead of a second change.
Responses
Section titled “Responses”The business profile, now in_review.
object
draft: being filled in. in_review: submitted, Loops is reviewing it.
approved: locations can go live on delivery apps. rejected: fix what the review says and submit again.
object
As on the commercial registration.
Commercial registration number, 10 digits.
VAT registration number, 15 digits starting and ending with 3.
The Saudi national address, as on the national address certificate.
object
object
The kind of document.
Set by the review. pending until Loops reviews it.
Document types needed before you can submit. Loops sets this per merchant.
object
What to fix, when the profile is rejected.
Example
{ "status": "draft", "details": { "legal_name": "شركة المذاق الأصيل للوجبات السريعة", "cr_number": "1010123456", "vat_number": "310123456700003", "national_address": { "building_number": "7421", "street": "Prince Turki Street", "district": "Al Olaya", "city": "Riyadh", "postal_code": "12214", "additional_number": "3156" } }, "documents": [ { "id": "doc_3Hn8Wq", "type": "commercial_registration", "status": "pending", "file_name": "cr-certificate.pdf", "rejection_reason": "The certificate has expired. Upload the current one." } ], "required_documents": [ "commercial_registration", "vat_certificate", "national_address_certificate", "iban_certificate" ]}The request is invalid. errors lists each problem.
RFC 9457 Problem Details with a stable code.
object
Stable machine-readable error code. Switch on this, not on title.
For external_ref_conflict, the ID of the object that already uses the reference.
Field errors, for invalid_request.
object
Example
{ "type": "https://docs.partners.loops.sa/errors/external_ref_conflict", "title": "External reference already used", "status": 409, "code": "invalid_request", "detail": "A location with external_ref BR-01 already exists.", "request_id": "req_01J9X7P2QK", "existing_id": "loc_2Xf9K", "errors": [ { "field": "products[3].price", "message": "Required unless the product has variants." } ]}The access token is missing, expired or invalid.
RFC 9457 Problem Details with a stable code.
object
Stable machine-readable error code. Switch on this, not on title.
For external_ref_conflict, the ID of the object that already uses the reference.
Field errors, for invalid_request.
object
Example
{ "type": "https://docs.partners.loops.sa/errors/external_ref_conflict", "title": "External reference already used", "status": 409, "code": "invalid_request", "detail": "A location with external_ref BR-01 already exists.", "request_id": "req_01J9X7P2QK", "existing_id": "loc_2Xf9K", "errors": [ { "field": "products[3].price", "message": "Required unless the product has variants." } ]}Not allowed: the scope isn’t approved or granted, the connection is not active,
or your application is suspended. See code.
RFC 9457 Problem Details with a stable code.
object
Stable machine-readable error code. Switch on this, not on title.
For external_ref_conflict, the ID of the object that already uses the reference.
Field errors, for invalid_request.
object
Example
{ "type": "https://docs.partners.loops.sa/errors/external_ref_conflict", "title": "External reference already used", "status": 409, "code": "invalid_request", "detail": "A location with external_ref BR-01 already exists.", "request_id": "req_01J9X7P2QK", "existing_id": "loc_2Xf9K", "errors": [ { "field": "products[3].price", "message": "Required unless the product has variants." } ]}The request conflicts with the current state, for example an external_ref already in use,
or a business profile that is in review. See code.
RFC 9457 Problem Details with a stable code.
object
Stable machine-readable error code. Switch on this, not on title.
For external_ref_conflict, the ID of the object that already uses the reference.
Field errors, for invalid_request.
object
Example
{ "type": "https://docs.partners.loops.sa/errors/external_ref_conflict", "title": "External reference already used", "status": 409, "code": "invalid_request", "detail": "A location with external_ref BR-01 already exists.", "request_id": "req_01J9X7P2QK", "existing_id": "loc_2Xf9K", "errors": [ { "field": "products[3].price", "message": "Required unless the product has variants." } ]}© 2026 Loops Technologies | شركة لووبز للتقنيات. All rights reserved.