Find a submission by document reference
curl --request GET \
--url https://api.nextlevelmca.com/v1/submissions/by-reference/{code} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.nextlevelmca.com/v1/submissions/by-reference/{code}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.nextlevelmca.com/v1/submissions/by-reference/{code}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"id": "<string>",
"deal_id": "<string>",
"lender_id": "<string>",
"lender_name": "<string>",
"status": "pending",
"submission_method": "email",
"api": {
"id": "<string>",
"submission_id": "<string>",
"deal_id": "<string>",
"lender_id": "<string>",
"funder_api_spec_id": "<string>",
"environment": "development",
"external_id": "<string>",
"funder_status": "<string>",
"internal_status": "queued",
"deep_link_url": "<string>",
"error_message": "<string>",
"error_code": "auth_failed",
"attempt_number": 123,
"submitted_at": "<string>",
"last_polled_at": "<string>",
"next_poll_at": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"can_retry": true,
"retry_after_seconds": 123
},
"response_type": "<string>",
"response_notes": "<string>",
"decline_reason": "<string>",
"decline_category": "<string>",
"requested_items": [
"<string>"
],
"match_score": 123,
"match_eligible": true,
"submitted_by_id": "<string>",
"submitted_at": "<string>",
"responded_at": "<string>",
"trace_code": "K7M3QX",
"created_at": "<string>",
"updated_at": "<string>"
},
"meta": {}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}Submissions
Find a submission by document reference
Every package emailed to a lender carries a short document reference — Ref K7M-3QX in light grey at the bottom of each page, and in the PDF keywords. Each lender gets a different reference for the same deal, so a package that resurfaces somewhere else tells you which lender had it. Pass the reference with or without the dash; the response is the submission it was sent under (lender, deal, when).
GET
/
v1
/
submissions
/
by-reference
/
{code}
Find a submission by document reference
curl --request GET \
--url https://api.nextlevelmca.com/v1/submissions/by-reference/{code} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.nextlevelmca.com/v1/submissions/by-reference/{code}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.nextlevelmca.com/v1/submissions/by-reference/{code}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"id": "<string>",
"deal_id": "<string>",
"lender_id": "<string>",
"lender_name": "<string>",
"status": "pending",
"submission_method": "email",
"api": {
"id": "<string>",
"submission_id": "<string>",
"deal_id": "<string>",
"lender_id": "<string>",
"funder_api_spec_id": "<string>",
"environment": "development",
"external_id": "<string>",
"funder_status": "<string>",
"internal_status": "queued",
"deep_link_url": "<string>",
"error_message": "<string>",
"error_code": "auth_failed",
"attempt_number": 123,
"submitted_at": "<string>",
"last_polled_at": "<string>",
"next_poll_at": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"can_retry": true,
"retry_after_seconds": 123
},
"response_type": "<string>",
"response_notes": "<string>",
"decline_reason": "<string>",
"decline_category": "<string>",
"requested_items": [
"<string>"
],
"match_score": 123,
"match_eligible": true,
"submitted_by_id": "<string>",
"submitted_at": "<string>",
"responded_at": "<string>",
"trace_code": "K7M3QX",
"created_at": "<string>",
"updated_at": "<string>"
},
"meta": {}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}Was this page helpful?