Trustvane API reference

Your business profile as you entered it, plus its Secretary-of-State verification verdict.

{
  "ok": true,
  "data": {
    "id": "b2c4…-guid",
    "legalName": "Acme Supply LLC",
    "dba": "Acme",
    "entityType": "Llc",
    "ein": "12-3456789",
    "website": "https://acme.example",
    "industry": "Wholesale",
    "dunsNumber": "123456789",
    "address": { "line1": "…", "city": "…", "state": "CO", "postalCode": "…", "country": "US" },
    "formationState": "WY",
    "yearOrganized": 2021,
    "foundedDate": "2021-04-12T00:00:00",
    "verification": { "status": "Verified", "verifiedUtc": "…", "nextCheckUtc": "…" },
    "isFurnishable": true,
    "createdUtc": "…"
  }
}

Your latest Fundability Readiness snapshot — a 0–100 readiness index built from data Trustvane already holds. data is null if no score has been computed yet.

{ "ok": true, "data": { "score": 72, "band": "Strong", "factorsJson": "[…]", "createdUtc": "…" } }

Not a credit score. It measures how ready your business looks to a lender, not your creditworthiness.

Recent fundability snapshots, newest first — the trend behind the current score. Optional ?take= (default 12, max 60).

{ "ok": true, "data": [ { "score": 72, "band": "Strong", "createdUtc": "…" }, … ] }

The trade relationships you track and whether each is reporting to the bureaus.

{
  "ok": true,
  "data": [
    {
      "id": "…-guid",
      "vendorName": "Uline",
      "vendorEin": "12-3456789",
      "accountNumber": "12345",
      "netTermsDays": 30,
      "currentBalance": 1800.00,
      "highCredit": 2500.00,
      "balanceAsOf": "2026-08-01",
      "aging": {
        "amt0to30": 1800.00, "amt31to60": 0, "amt61to90": 0,
        "amt91to120": 0, "amt121plus": 0, "totalPastDue": 1800.00
      },
      "reportingStatus": "Expected",
      "confirmationSource": "CatalogExpected",
      "reportsTo": { "dun": true, "experian": false, "equifax": false, "cortera": false },
      "isActive": true,
      "attestedUtc": "…",
      "createdUtc": "…"
    }
  ]
}

Expected is not Confirmed. A vendor believed to report is only Expected until a payment actually lands on your file.

UCC financing statements on public record naming your business as debtor, from the most recent search we ran.

{
  "ok": true,
  "data": [
    {
      "stateCode": "WY",
      "fileNumber": "2022-1234567",
      "fileDate": "04/12/2022",
      "securedParty": "Example Capital",
      "collateral": "All assets",
      "status": "Active",
      "isActive": true,
      "firstSeenUtc": "…",
      "lastSeenUtc": "…"
    }
  ]
}

An empty array means the most recent search found nothing — not that no search has run. The Liens page in-app distinguishes those states in full.

The compliance and filing obligations Trustvane tracks for your business (annual reports, registered agent, taxes, BOI, and any you added).

{
  "ok": true,
  "data": [
    {
      "id": "…-guid",
      "title": "State annual report",
      "category": "State filing",
      "cadence": "Annual",
      "dueDate": "2026-04-15T00:00:00",
      "status": "Open",
      "verifyWith": "Secretary of State",
      "verifyUrl": "https://…"
    }
  ]
}

Dates are estimates to confirm with the named authority — informational, not legal advice.

Create a tradeline. Only vendorName is required. You may also send the vendor's identity, the account's balances and aging, and the date those figures are current as of.

curl -X POST https://app.trustvane.com/api/v1/me/tradelines \
  -H "Authorization: Bearer tv_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "vendorName": "Uline",
    "vendorDba": "Uline Shipping Supplies",
    "vendorState": "IL",
    "vendorEin": "12-3456789",
    "accountNumber": "12345",
    "netTermsDays": 30,
    "creditLimit": 2500,
    "highCredit": 2500,
    "currentBalance": 1800,
    "amt0to30": 1800,
    "balanceAsOf": "2026-08-01",
    "accountOpenedDate": "2025-06-01",
    "reportsExperian": true,
    "note": "Account #12345",
    "attested": true,
    "attestedName": "Jordan Doe"
  }'

Returns 201 with the created tradeline (its id is a GUID you use below).

Fields

All optional except vendorName. Vendor identity: vendorDba, vendorAddress, vendorCity, vendorZip, vendorPhone, vendorWebsite, vendorState (2-letter), vendorEin. Account: accountNumber, netTermsDays, creditLimit, accountOpenedDate. Trade experience: currentBalance, highCredit, aging buckets amt0to30 / amt31to60 / amt61to90 / amt91to120 / amt121plus, and balanceAsOf (the date those figures are current as of). Bureau bits: reportsExperian, reportsDun, reportsEquifax, reportsCortera.

Validation & attestation

vendorEin must be a 9-digit federal EIN (any punctuation is accepted; it is stored as ##-#######). All amounts must be non-negative and balanceAsOf cannot be in the future. Because a tradeline is furnished to the bureau as a self-reported line on your file, you must send attested: true to affirm the information is accurate; optionally include attestedName. A failed check returns 400 with a validation_failed code. Non-blocking data-quality hints (for example, aging buckets that don't add up to the balance) come back in a warnings array on an otherwise successful response.

Update a tradeline. Send only the fields you want to change. A change re-queues the line to furnish an update on the next push. Changing any balance, aging bucket, EIN or balanceAsOf requires re-sending attested: true.

Remove a tradeline you no longer want to report.

Find a business and its CredX account id. Free — no charge, no quota. ?q=<name> or ?ein=<ein>.

{ "ok": true, "data": { "count": 1, "results": [
  { "accountId": "1000042", "name": "Acme Supply LLC", "city": "Denver", "state": "CO", "claimed": true }
] } }

Pull a full credit report. Pass accountId (from search) or ein to resolve one. Billed net-30 on success.

curl -X POST https://app.trustvane.com/api/v1/credit/reports \
  -H "Authorization: Bearer tv_live_..." \
  -d "accountId=1000042"

{ "ok": true, "data": {
  "id": "…-guid", "limited": false, "billed": true,
  "charge": { "amount": 2.95, "invoiceNumber": "TV-000123", "dueUtc": "…", "terms": "NET 30" },
  "availableCredit": 497.05,
  "report": { "business": { … }, "scores": { … }, "principals": [ … ], "tradeLines": [ … ] }
} }

A GET to the same path returns your pull history and net-30 credit state (limit, available, price).

Order a curated company list. Body: state, industry (or NAICS), count, optional note. Billed net-30 up front; the list is compiled and delivered, and the order status is available with a GET.

{ "ok": true, "data": {
  "id": "…-guid", "status": "Queued", "estimatedRecords": 250, "price": 125.00,
  "charge": { "amount": 125.00, "invoiceNumber": "TV-000124", "dueUtc": "…", "terms": "NET 30" }
} }