Test the API - Pascal Developer Docs

Create the test datasource

Open Admin → Connectors → Custom Source. Create a new datasource named test with document types purchase_order. Save its client ID, fingerprint, and private key.

Get a token

Follow Quickstart using the test datasource’s credentials and CLIENT_ID = "<tenant_slug>/test". Copy the returned token into your shell:

export TOKEN='<access_token>'
export BASE_URL='https://app.teampascal.com/api/v1/custom-source'

Open a dry-run upload

UPLOAD_ID=$(curl --fail-with-body -sS "$BASE_URL/uploads" \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"datasource":"test","doc_type":"purchase_order","mode":"incremental","dry_run":true}' | jq -r '.upload_id')

Send ten sample purchase orders

Save this as records.json:

{"records": [
  {"id": "1001", "data": {"PONumber": "PO-88201", "Customer": "Example Foods", "OrderDate": "2026-09-01", "Lines": [{"SKU": "SKU-100", "Qty": 1}]}},
  {"id": "1002", "data": {"PONumber": "PO-88202", "Customer": "Example Foods", "OrderDate": "2026-09-01", "Lines": [{"SKU": "SKU-100", "Qty": 1}]}},
  {"id": "1003", "data": {"PONumber": "PO-88203", "Customer": "Example Foods", "OrderDate": "2026-09-01", "Lines": [{"SKU": "SKU-100", "Qty": 1}]}},
  {"id": "1004", "data": {"PONumber": "PO-88204", "Customer": "Example Foods", "OrderDate": "2026-09-01", "Lines": [{"SKU": "SKU-100", "Qty": 1}]}},
  {"id": "1005", "data": {"PONumber": "PO-88205", "Customer": "Example Foods", "OrderDate": "2026-09-01", "Lines": [{"SKU": "SKU-100", "Qty": 1}]}},
  {"id": "1006", "data": {"PONumber": "PO-88206", "Customer": "Example Foods", "OrderDate": "2026-09-01", "Lines": [{"SKU": "SKU-100", "Qty": 1}]}},
  {"id": "1007", "data": {"PONumber": "PO-88207", "Customer": "Example Foods", "OrderDate": "2026-09-01", "Lines": [{"SKU": "SKU-100", "Qty": 1}]}},
  {"id": "1008", "data": {"PONumber": "PO-88208", "Customer": "Example Foods", "OrderDate": "2026-09-01", "Lines": [{"SKU": "SKU-100", "Qty": 1}]}},
  {"id": "1009", "data": {"PONumber": "PO-88209", "Customer": "Example Foods", "OrderDate": "2026-09-01", "Lines": [{"SKU": "SKU-100", "Qty": 1}]}},
  {"id": "1010", "data": {"PONumber": "PO-88210", "Customer": "Example Foods", "OrderDate": "2026-09-01", "Lines": [{"SKU": "SKU-100", "Qty": 1}]}}
]}

curl --fail-with-body -sS -X PUT "$BASE_URL/uploads/$UPLOAD_ID/records" \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  --data-binary @records.json

The response has accepted: 10 and record_count: 10.

Send one more

curl --fail-with-body -sS -X PUT "$BASE_URL/uploads/$UPLOAD_ID/records" \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"records":[{"id":"1011","data":{"PONumber":"PO-88211","Customer":"Example Foods","OrderDate":"2026-09-01","Lines":[{"SKU":"SKU-100","Qty":1}]}}]}'

The response has accepted: 1 and record_count: 11.

Close the upload

curl --fail-with-body -sS -X POST "$BASE_URL/uploads/$UPLOAD_ID/close" \
  -H "Authorization: Bearer $TOKEN"

The response has status: "done".

Read the report

curl --fail-with-body -sS "$BASE_URL/uploads/$UPLOAD_ID" \
  -H "Authorization: Bearer $TOKEN" \
  | jq '{status, dry_run, record_count, merged_counts, report: {status: .report.status, errors: .report.errors}}'

Expected output:

{
  "status": "done",
  "dry_run": true,
  "record_count": 11,
  "merged_counts": null,
  "report": {"status": "passed", "errors": []}
}

If close returned status: "rejected", drop the report projection from the jq filter and read report.per_type[].errors for the finding to fix; top-level report.errors is empty on both outcomes.report.per_type lists warnings for each document type, such as a missing SKU map or sampled values that don’t match the expected field type. Warnings don’t block the upload. Pascal reviews and resolves mapping warnings on its side, so you don’t need to change your payload unless Pascal asks. The dry run leaves documents unchanged.