{"openapi":"3.1.0","info":{"title":"Business Credit API","version":"0.1.0","description":"Small-business credit-building basics: personal vs. business credit distinction, building-block steps, a PAYDEX score explainer, common early-stage mistakes, a net-30 vendor explainer, a readiness score, and a glossary — all local, hand-curated, no upstream calls.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://businesscredit.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/businesscredit/docs"},"termsOfService":"https://connectorbay.com/businesscredit/terms"},"servers":[{"url":"https://businesscredit.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/businesscredit/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/personal_vs_business_credit_explainer":{"post":{"operationId":"personal_vs_business_credit_explainer","summary":"Explains how business credit (EIN/D-U-N-S-based, generally publicly pullable) differs from personal","description":"Explains how business credit (EIN/D-U-N-S-based, generally publicly pullable) differs from personal\n    credit (SSN-based, permission-based), and why the distinction matters. Use for \"what's the difference\n    between personal and business credit\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"personal_vs_business_credit_explainerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/business_credit_building_steps":{"post":{"operationId":"business_credit_building_steps","summary":"The ordered building blocks for establishing business credit: entity formation, EIN, a dedicated","description":"The ordered building blocks for establishing business credit: entity formation, EIN, a dedicated\n    business bank account, a D-U-N-S number, net-30 vendor tradelines, a business credit card, on-time\n    payment, and periodic monitoring. Use for \"how do I build business credit\", \"steps to establish business\n    credit\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"business_credit_building_stepsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/paydex_score_explainer":{"post":{"operationId":"paydex_score_explainer","summary":"Explains Dun & Bradstreet's PAYDEX score: the 1-100 scale, what each range means, what drives it (pure","description":"Explains Dun & Bradstreet's PAYDEX score: the 1-100 scale, what each range means, what drives it (pure\n    payment timing), and what's needed to have one at all. Use for \"what's a PAYDEX score\", \"what PAYDEX score\n    is good\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"paydex_score_explainerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/common_mistakes_checklist":{"post":{"operationId":"common_mistakes_checklist","summary":"Common early-stage business-credit mistakes — especially commingling personal and business finances —","description":"Common early-stage business-credit mistakes — especially commingling personal and business finances —\n    and why each one hurts. Use for \"what mistakes should I avoid building business credit\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"common_mistakes_checklistArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/net30_vendor_concept_explainer":{"post":{"operationId":"net30_vendor_concept_explainer","summary":"What a net-30 vendor tradeline is, why it helps new businesses build credit, common vendor categories,","description":"What a net-30 vendor tradeline is, why it helps new businesses build credit, common vendor categories,\n    and how to actually use one to build a payment history. Use for \"what's a net-30 vendor\", \"how do net-30\n    accounts build business credit\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"net30_vendor_concept_explainerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/business_credit_readiness_score":{"post":{"operationId":"business_credit_readiness_score","summary":"Scores a business's own credit-building practices (true/false answers) into a weighted readiness score,","description":"Scores a business's own credit-building practices (true/false answers) into a weighted readiness score,\n    a band, and specific recommendations for anything not yet in place. Use for \"is my business ready to build\n    credit\", \"what should I do next to build business credit\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"practices":{"additionalProperties":{"type":"boolean"},"description":"True/false answers: has_registered_business_entity, has_ein, has_dedicated_business_bank_account, has_duns_number, has_reporting_net30_vendor_tradelines, has_business_credit_card_used_only_for_business, pays_all_business_obligations_on_time_or_early, monitors_business_credit_file_periodically. Omitted keys count as false.","title":"Practices","type":"object"}},"required":["practices"],"title":"business_credit_readiness_scoreArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/business_credit_glossary":{"post":{"operationId":"business_credit_glossary","summary":"Definitions of business-credit terms: EIN, D-U-N-S number, PAYDEX score, net-30 vendor/tradeline, trade","description":"Definitions of business-credit terms: EIN, D-U-N-S number, PAYDEX score, net-30 vendor/tradeline, trade\n    credit, personal guarantee, business credit file, commingling, business credit card, secured business\n    credit. Use for \"what's an EIN\", \"what's a personal guarantee\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"business_credit_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}