Company credit scoring APIs

Mock Creditsafe Connect credit reports for catalogue suppliers in UK, Germany, and France, and mock Dun & Bradstreet Direct Commercial Credit Score (CCS) for the US. Paths follow the public vendor docs — not invented shapes.

Base URL for examples: https://mock-server.oscar-int.prc.re

Creditsafe Connect (GB / DE / FR)

Public docs: Credit and Risk. Auth defaults: CREDITSAFE_USERNAME / CREDITSAFE_PASSWORD → procureai / demo.

Authenticate

curl -s -X POST https://mock-server.oscar-int.prc.re/v1/authenticate \
  -H 'Content-Type: application/json' \
  -d '{"username":"procureai","password":"demo"}'

Search (UK example)

TOKEN=$(curl -s -X POST https://mock-server.oscar-int.prc.re/v1/authenticate \
  -H 'Content-Type: application/json' \
  -d '{"username":"procureai","password":"demo"}' | jq -r .token)

curl -s "https://mock-server.oscar-int.prc.re/v1/companies?countries=GB&name=OfficePro" \
  -H "Authorization: Bearer $TOKEN"

{
  "totalSize": 1,
  "companies": [
    {
      "id": "GB-0-09876543",
      "country": "GB",
      "regNo": "09876543",
      "safeNo": "UK09876543",
      "name": "OFFICEPRO SUPPLIES LIMITED",
      "status": "Active",
      "address": {
        "simpleValue": "14 KING STREET, MANCHESTER, M2 6AG",
        "street": "KING STREET",
        "city": "MANCHESTER",
        "postCode": "M2 6AG"
      }
    }
  ]
}

Credit report (DE — reason code required)

curl -s "https://mock-server.oscar-int.prc.re/v1/companies/DE-0-HRB712345?customData=de_reason_code::1" \
  -H "Authorization: Bearer $TOKEN"

France example connectId: FR-0-532123456 (no reason code).

creditRating fields (from live mock report)

Creditsafe monitoring

Portfolios, event rules and notification events, keyed on the same effective rating the credit report endpoints serve.

Event rules

Create a portfolio and add a company

CS_TOKEN=$(curl -s -X POST https://mock-server.oscar-int.prc.re/v1/authenticate \
  -H 'Content-Type: application/json' \
  -d '{"username":"procureai","password":"demo"}' | jq -r .token)

PID=$(curl -s -X POST https://mock-server.oscar-int.prc.re/v1/monitoring/portfolios -H "Authorization: Bearer $CS_TOKEN" \
  -H 'Content-Type: application/json' -d '{"name":"Procure Ai suppliers"}' | jq -r .portfolioId)

curl -s -X POST "https://mock-server.oscar-int.prc.re/v1/monitoring/portfolios/$PID/companies" -H "Authorization: Bearer $CS_TOKEN" \
  -H 'Content-Type: application/json' -d '{"id":"DE-0-HRB723456","personalReference":"","freeText":"","personalLimit":""}'

Scripted rating change & cost units

Mock-only endpoints that move a rating and emit the matching provider-shaped notifications.

Default demo (screen 09): WorkSpace Interiors Inc. class 2 (LOW) → class 4 (HIGH)

curl -s -X POST https://mock-server.oscar-int.prc.re/v1/monitoring/registrations/procureai-credit/duns/362241452 \
  -H "Authorization: Bearer $DNB_TOKEN"

curl -s -X POST https://mock-server.oscar-int.prc.re/api/scenarios/credit/rating-change -H "Authorization: Bearer $DNB_TOKEN"

curl -s "https://mock-server.oscar-int.prc.re/v1/monitoring/registrations/procureai-credit/pull" -H "Authorization: Bearer $DNB_TOKEN"

TechLine (Creditsafe DE) B → D

curl -s -X POST https://mock-server.oscar-int.prc.re/api/scenarios/credit/rating-change -H "Authorization: Bearer $CS_TOKEN" \
  -H 'Content-Type: application/json' -d '{"provider":"creditsafe","id":"DE-0-HRB723456","band":"HIGH"}'

Presets

Cost units (header X-Mock-Cost-Units)