Developer Reference

Fetch a verified company profile by its unique slug. Companies that are not yet verified return 404 — use this endpoint to gate access in your own platform.

curl https://businesspartnervetting.com/api/v1/profiles/acme-capital-llc \
  -H "Authorization: Bearer bpv_your_api_key_here"

{
  "id": "a1b2c3d4-...",
  "slug": "acme-capital-llc",
  "name": "Acme Capital LLC",
  "tier": "tier3",
  "tierName": "Professional",
  "status": "verified",
  "verifiedAt": "2026-05-15T14:30:00.000Z",
  "profileUrl": "https://businesspartnervetting.com/profile/acme-capital-llc",
  "badges": [
    { "slug": "identity_verified", "type": "Identity Verified", "awardedAt": "2026-05-15T14:30:00.000Z" },
    { "slug": "corporate_entity_verified", "type": "Corporate Entity Verified", "awardedAt": "2026-05-15T14:30:00.000Z" },
    { "slug": "banking_relationship_verified", "type": "Banking Relationship Verified", "awardedAt": "2026-05-15T14:30:00.000Z" },
    { "slug": "financials_reviewed", "type": "Financials Reviewed", "awardedAt": "2026-05-15T14:30:00.000Z" }
  ]
}

Includes all fields above plus a documents array.

{
  ...profile fields,
  "documents": [
    {
      "category": "Banking & Financial Verification",
      "filename": "bank-statement-q1-2026.pdf",
      "uploadedAt": "2026-05-10T09:15:00.000Z",
      "reviewStatus": "approved",
      "url": "https://..."
    }
  ]
}

Look up all verified profiles associated with an email address. Returns an array — a single email may have multiple verified entities (e.g. an individual who verified two separate companies). Unverified companies are excluded.

curl "https://businesspartnervetting.com/api/v1/profiles?email=john@acmecapital.com" \
  -H "Authorization: Bearer bpv_your_api_key_here"

{
  "profiles": [
    {
      "id": "a1b2c3d4-...",
      "slug": "acme-capital-llc",
      "name": "Acme Capital LLC",
      "tier": "tier3",
      "tierName": "Professional",
      "status": "verified",
      "verifiedAt": "2026-05-15T14:30:00.000Z",
      "profileUrl": "https://businesspartnervetting.com/profile/acme-capital-llc",
      "badges": [
        { "slug": "identity_verified", "type": "Identity Verified", "awardedAt": "2026-05-15T14:30:00.000Z" }
      ]
    }
  ]
}

Returns { "profiles": [] } when no verified profiles are found — whether the email is unknown or the company is still pending review. The verifiedAt field is an ISO 8601 timestamp or null if verification has not yet completed.

Batch lookup — resolve up to 50 email addresses in one request. Returns a map keyed by email. Emails with no verified profile return an empty array.

{ "emails": ["john@acmecapital.com", "jane@otherfirm.com"] }

curl -X POST https://businesspartnervetting.com/api/v1/profiles/lookup \
  -H "Authorization: Bearer bpv_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"emails":["john@acmecapital.com","jane@otherfirm.com"]}'

{
  "results": {
    "john@acmecapital.com": [
      {
        "id": "a1b2c3d4-...",
        "slug": "acme-capital-llc",
        "name": "Acme Capital LLC",
        "tier": "tier3",
        "tierName": "Professional",
        "status": "verified",
        "verifiedAt": "2026-05-15T14:30:00.000Z",
        "profileUrl": "https://businesspartnervetting.com/profile/acme-capital-llc",
        "badges": [
          { "slug": "identity_verified", "type": "Identity Verified", "awardedAt": "2026-05-15T14:30:00.000Z" }
        ]
      }
    ],
    "jane@otherfirm.com": []
  }
}

Public name search — returns up to 10 verified companies whose names contain the query string (case-insensitive). Useful for building search-as-you-type UIs. No API key required. Query must be at least 2 characters.

curl "https://businesspartnervetting.com/api/v1/profiles/search?q=acme"

{
  "results": [
    {
      "name": "Acme Capital LLC",
      "slug": "acme-capital-llc",
      "tierName": "Professional",
      "verifiedAt": "2026-05-15T14:30:00.000Z",
      "badgeCount": 4,
      "profileUrl": "https://businesspartnervetting.com/profile/acme-capital-llc"
    }
  ]
}

Returns { "results": [] } when the query is under 2 characters or no verified companies match. Only verified companies appear in results.

Initiate a verification on behalf of a business partner. BPV creates a pending profile, generates a 30-day upload link, and emails it directly to the subject company. You receive a review.completed webhook when their profile is verified. Enterprise (tier5) requires a direct arrangement — contact us.

curl -X POST https://businesspartnervetting.com/api/v1/verification-requests \
  -H "Authorization: Bearer bpv_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "subject_email": "cfo@partnerfirm.com",
    "subject_company": "Partner Firm LLC",
    "tier_id": "tier2"
  }'

{
  "request_id": "api_req_a1b2c3d4e5f6...",
  "subject_email": "cfo@partnerfirm.com",
  "subject_company": "Partner Firm LLC",
  "tier": "Standard",
  "upload_url": "https://businesspartnervetting.com/upload/eyJ...",
  "expires_at": "2026-06-21T14:30:00.000Z"
}

The upload_url is a 30-day JWT-signed link sent directly to subject_email. You can also embed it in your own onboarding flow. Note: the tier field here is the tier name (e.g. Standard), not the ID — unlike profile endpoints which return the tier ID in tier. See the Tier Reference for the full mapping. Billing is settled monthly against your API agreement — no per-request Stripe checkout.