{"openapi":"3.1.0","info":{"title":"co-founder.net agent API","version":"1.1.0","description":"co-founder.net lists startups that publicly look for a co-founder, startups hiring founding-team roles, early-stage startups from public directories (co-founder search not confirmed), and people open to co-founding — in 20 languages. Use search_startups / get_startup and search_cofounders / get_cofounder to read (free), request_introduction to ask the team for an intro (free). Paid: unlock_startup (name, website, source), order_warm_intro, order_shortlist, set_alerts — open an account with create_account (no human needed), top up with buy_credits (USDC via x402 on Base or Solana, Bitcoin Lightning, Stripe), then send the api_key as a Bearer token. Pay per call without an account: GET /agents/api/startups/{id}/unlock answers HTTP 402 (x402 / L402). Same tools as the MCP server at https://co-founder.net/mcp and the A2A agent at https://co-founder.net/a2a.","contact":{"email":"ag@brn.ai","url":"https://co-founder.net/agents/"},"termsOfService":"https://co-founder.net/legal/terms/"},"servers":[{"url":"https://co-founder.net/agents/api"}],"components":{"schemas":{"search_startups_input":{"type":"object","properties":{"query":{"type":"string","description":"Free text: product, technology, skill, city …","maxLength":200},"listing_type":{"type":"string","enum":["all","cofounder","founding","directory"],"default":"all"},"role":{"type":"string","enum":["cto","ai","mobile","web3","data","hardware","science","design","product","ceo","sales","growth","operations","finance","domain","community","open"],"description":"Co-founder/founding role: cto (technical), ai, mobile, web3, data, hardware, science, design, product, ceo (business), sales, growth, operations, finance, domain (industry expert), community, open (any)"},"industry":{"type":"string","enum":["ai","saas","fintech","health","bio","climate","edtech","consumer","commerce","marketplace","devtools","security","mobility","proptech","food","media","gaming","work","legal","web3","hardware","deeptech","travel","impact"]},"region":{"type":"string","enum":["north-america","latin-america","europe","east-europe","mena","africa","south-asia","east-asia","southeast-asia","oceania","anywhere"]},"country":{"type":"string","description":"ISO 3166-1 alpha-2 code, e.g. DE, US, IN","maxLength":2},"stage":{"type":"string","enum":["idea","prototype","mvp","revenue","funded","unknown"]},"commitment":{"type":"string","enum":["full-time","part-time","flexible","unknown"]},"terms":{"type":"string","enum":["equity-only","equity-salary","salary","unknown"]},"work_mode":{"type":"string","enum":["remote","hybrid","on-site","unknown"]},"freshness":{"type":"string","enum":["new","recent","older","live"],"description":"new ≤ 60 days, recent ≤ 12 months, older, live = undated but online"},"sort":{"type":"string","enum":["newest","oldest"],"default":"newest"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10},"offset":{"type":"integer","minimum":0,"default":0},"lang":{"type":"string","enum":["en","ar","zh","es","fr","de","pt","ru","ja","ko","it","tr","nl","pl","uk","hi","id","fa","ur","vi"],"description":"Language for headlines and summaries (default en). Every listing exists in 20 languages; where a translation is missing, English is returned."}},"additionalProperties":false},"get_startup_input":{"type":"object","properties":{"id":{"type":"string","description":"Startup id, e.g. SU-0123","pattern":"^[Ss][Uu]-?\\d{1,6}$"},"lang":{"type":"string","enum":["en","ar","zh","es","fr","de","pt","ru","ja","ko","it","tr","nl","pl","uk","hi","id","fa","ur","vi"],"description":"Language for headlines and summaries (default en). Every listing exists in 20 languages; where a translation is missing, English is returned."}},"required":["id"],"additionalProperties":false},"search_cofounders_input":{"type":"object","properties":{"query":{"type":"string","maxLength":200},"role":{"type":"string","enum":["cto","ai","mobile","web3","data","hardware","science","design","product","ceo","sales","growth","operations","finance","domain","community","open"],"description":"Co-founder/founding role: cto (technical), ai, mobile, web3, data, hardware, science, design, product, ceo (business), sales, growth, operations, finance, domain (industry expert), community, open (any)"},"industry":{"type":"string","enum":["ai","saas","fintech","health","bio","climate","edtech","consumer","commerce","marketplace","devtools","security","mobility","proptech","food","media","gaming","work","legal","web3","hardware","deeptech","travel","impact"]},"region":{"type":"string","enum":["north-america","latin-america","europe","east-europe","mena","africa","south-asia","east-asia","southeast-asia","oceania","anywhere"]},"country":{"type":"string","description":"ISO 3166-1 alpha-2 code, e.g. DE, US, IN","maxLength":2},"commitment":{"type":"string","enum":["full-time","part-time","flexible","unknown"]},"work_mode":{"type":"string","enum":["remote","hybrid","on-site","unknown"]},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10},"offset":{"type":"integer","minimum":0,"default":0}},"additionalProperties":false},"get_cofounder_input":{"type":"object","properties":{"ref":{"type":"string","pattern":"^[Cc][Ff]-?\\d{1,6}$"}},"required":["ref"],"additionalProperties":false},"list_categories_input":{"type":"object","additionalProperties":false},"get_service_info_input":{"type":"object","additionalProperties":false},"create_account_input":{"type":"object","properties":{"email":{"type":"string","format":"email","description":"Optional: receipts, alerts, introductions"},"name":{"type":"string","maxLength":120},"organization":{"type":"string","maxLength":160},"accept_terms":{"type":"boolean","description":"Must be true: you accept the terms at /legal/terms/ on behalf of the person or company you act for"},"agent":{"type":"object","description":"Optional: who is calling, for our records.","properties":{"name":{"type":"string"},"url":{"type":"string"},"on_behalf_of":{"type":"string","description":"Person or company the agent acts for"}}}},"required":["accept_terms"],"additionalProperties":false},"get_account_input":{"type":"object","properties":{"api_key":{"type":"string","description":"Your API key from create_account (alternative to the Authorization: Bearer header)"}},"additionalProperties":false},"buy_credits_input":{"type":"object","properties":{"pack":{"type":"string","description":"Pack id from get_service_info, e.g. c100"},"method":{"type":"string","enum":["x402","lightning","stripe_spt","saved_card","stripe_checkout"]},"currency":{"type":"string","enum":["usd","eur"],"description":"Card payments only (default usd). Crypto and Lightning are priced in USD."},"network":{"type":"string","description":"x402 only: base or solana (default: all enabled networks are offered)"},"shared_payment_token":{"type":"string","description":"stripe_spt only: the Stripe shared payment token (spt_…) your platform issued for this merchant","maxLength":200},"api_key":{"type":"string","description":"Your API key from create_account (alternative to the Authorization: Bearer header)"}},"required":["pack","method"],"additionalProperties":false},"confirm_payment_input":{"type":"object","properties":{"payment_hash":{"type":"string","maxLength":128},"checkout_session":{"type":"string","maxLength":200},"api_key":{"type":"string","description":"Your API key from create_account (alternative to the Authorization: Bearer header)"}},"additionalProperties":false},"unlock_startup_input":{"type":"object","properties":{"id":{"type":"string","pattern":"^[Ss][Uu]-?\\d{1,6}$"},"api_key":{"type":"string","description":"Your API key from create_account (alternative to the Authorization: Bearer header)"}},"required":["id"],"additionalProperties":false},"request_introduction_input":{"type":"object","properties":{"target":{"type":"string","description":"SU-… (startup) or CF-… (person)","pattern":"^([Ss][Uu]|[Cc][Ff])-?\\d{1,6}$"},"email":{"type":"string","format":"email","description":"Where the reply goes"},"name":{"type":"string","maxLength":120},"organization":{"type":"string","maxLength":160},"about":{"type":"string","maxLength":3000,"description":"Who you (or your principal) are, what you build or bring, why this fits"},"phone":{"type":"string","maxLength":60},"agent":{"type":"object","description":"Optional: who is calling, for our records.","properties":{"name":{"type":"string"},"url":{"type":"string"},"on_behalf_of":{"type":"string","description":"Person or company the agent acts for"}}}},"required":["target","email","about"],"additionalProperties":false},"order_warm_intro_input":{"type":"object","properties":{"ref":{"type":"string","pattern":"^[Cc][Ff]-?\\d{1,6}$"},"pitch":{"type":"string","maxLength":3000,"description":"What you build, the role you offer, terms, why this person"},"organization":{"type":"string","maxLength":160},"name":{"type":"string","maxLength":120},"phone":{"type":"string","maxLength":40},"idempotency_key":{"type":"string","maxLength":64},"api_key":{"type":"string","description":"Your API key from create_account (alternative to the Authorization: Bearer header)"}},"required":["ref","pitch"],"additionalProperties":false},"order_shortlist_input":{"type":"object","properties":{"role":{"type":"string","enum":["cto","ai","mobile","web3","data","hardware","science","design","product","ceo","sales","growth","operations","finance","domain","community","open"],"description":"Co-founder/founding role: cto (technical), ai, mobile, web3, data, hardware, science, design, product, ceo (business), sales, growth, operations, finance, domain (industry expert), community, open (any)"},"stage":{"type":"string","enum":["idea","prototype","mvp","revenue","funded"]},"industry":{"type":"string","enum":["ai","saas","fintech","health","bio","climate","edtech","consumer","commerce","marketplace","devtools","security","mobility","proptech","food","media","gaming","work","legal","web3","hardware","deeptech","travel","impact"]},"commitment":{"type":"string","enum":["full-time","part-time","flexible"]},"place":{"type":"string","maxLength":200,"description":"City/country or remote"},"notes":{"type":"string","maxLength":3000,"description":"What you build and who you need"},"organization":{"type":"string","maxLength":160},"name":{"type":"string","maxLength":120},"idempotency_key":{"type":"string","maxLength":64},"api_key":{"type":"string","description":"Your API key from create_account (alternative to the Authorization: Bearer header)"}},"required":["role","notes"],"additionalProperties":false},"set_alerts_input":{"type":"object","properties":{"active":{"type":"boolean"},"roles":{"type":"array","items":{"type":"string","enum":["cto","ai","mobile","web3","data","hardware","science","design","product","ceo","sales","growth","operations","finance","domain","community","open"]},"maxItems":17},"countries":{"type":"array","items":{"type":"string","maxLength":2},"maxItems":40},"api_key":{"type":"string","description":"Your API key from create_account (alternative to the Authorization: Bearer header)"}},"required":["active"],"additionalProperties":false},"get_request_status_input":{"type":"object","properties":{"request_id":{"type":"string","maxLength":40},"email":{"type":"string","format":"email"},"api_key":{"type":"string","description":"Your API key from create_account (alternative to the Authorization: Bearer header)"}},"required":["request_id"],"additionalProperties":false}},"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"api_key from POST /accounts (prefix cfk_)"}}},"paths":{"/tools":{"get":{"operationId":"listTools","summary":"All tools with JSON input schemas","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/call":{"post":{"operationId":"callTool","summary":"Call any tool by name: {\"tool\": \"<name>\", \"arguments\": {…}}","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","enum":["search_startups","get_startup","search_cofounders","get_cofounder","list_categories","get_service_info","create_account","get_account","buy_credits","confirm_payment","unlock_startup","request_introduction","order_warm_intro","order_shortlist","set_alerts","get_request_status"]},"arguments":{"type":"object"}},"required":["tool"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/startups":{"get":{"operationId":"searchStartups","summary":"Search startups","parameters":[{"name":"query","in":"query","required":false,"description":"Search words","schema":{"type":"string"}},{"name":"listing_type","in":"query","required":false,"description":"all, cofounder, founding, directory","schema":{"type":"string"}},{"name":"role","in":"query","required":false,"description":"Role","schema":{"type":"string"}},{"name":"industry","in":"query","required":false,"description":"Industry","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"Region","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO alpha-2","schema":{"type":"string"}},{"name":"stage","in":"query","required":false,"description":"Stage","schema":{"type":"string"}},{"name":"commitment","in":"query","required":false,"description":"Commitment","schema":{"type":"string"}},{"name":"terms","in":"query","required":false,"description":"Terms","schema":{"type":"string"}},{"name":"work_mode","in":"query","required":false,"description":"Work mode","schema":{"type":"string"}},{"name":"freshness","in":"query","required":false,"description":"new, recent, older, live","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1–50)","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"integer"}},{"name":"lang","in":"query","required":false,"description":"Language","schema":{"type":"string","enum":["en","ar","zh","es","fr","de","pt","ru","ja","ko","it","tr","nl","pl","uk","hi","id","fa","ur","vi"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/startups/{id}":{"get":{"operationId":"getStartup","summary":"One startup","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Language","schema":{"type":"string","enum":["en","ar","zh","es","fr","de","pt","ru","ja","ko","it","tr","nl","pl","uk","hi","id","fa","ur","vi"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/startups/{id}/unlock":{"get":{"operationId":"unlockStartup","summary":"Name, website and source of one startup. With a Bearer api_key: credits. Without: HTTP 402 — pay with x402 (X-PAYMENT / PAYMENT-SIGNATURE header) or L402 (Authorization: L402 <token>:<preimage>), then repeat the request.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}},"post":{"operationId":"unlockStartupPost","summary":"Same as GET","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/cofounders":{"get":{"operationId":"searchCofounders","summary":"Search people open to co-founding","parameters":[{"name":"query","in":"query","required":false,"description":"Search words","schema":{"type":"string"}},{"name":"role","in":"query","required":false,"description":"Role","schema":{"type":"string"}},{"name":"industry","in":"query","required":false,"description":"Industry","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"Region","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO alpha-2","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/cofounders/{ref}":{"get":{"operationId":"getCofounder","summary":"One co-founder profile","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/categories":{"get":{"operationId":"listCategories","summary":"Roles, industries, regions with counts","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/service":{"get":{"operationId":"getServiceInfo","summary":"Prices, packs and payment methods","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/accounts":{"post":{"operationId":"createAccount","summary":"Open an account; returns api_key","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_account_input"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/account":{"get":{"operationId":"getAccount","summary":"Balance and history","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}},"security":[{"bearer":[]}]}},"/credits/buy":{"post":{"operationId":"buyCredits","summary":"Buy a credit pack (x402, lightning, stripe_spt, saved_card, stripe_checkout)","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/buy_credits_input"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}},"security":[{"bearer":[]}]}},"/credits/topup":{"post":{"operationId":"topUpCredits","summary":"Top up a credit pack by HTTP 402: x402 (USDC on Base/Solana: PAYMENT-SIGNATURE or X-PAYMENT), L402 (Authorization: L402 <macaroon>:<preimage>) or MPP (Authorization: Payment …). Send your api_key in X-API-Key. Query: pack=c100","parameters":[{"name":"pack","in":"query","required":false,"description":"Pack id","schema":{"type":"string"}},{"name":"network","in":"query","required":false,"description":"x402 only: base or solana","schema":{"type":"string"}}],"security":[{"bearer":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/credits/confirm":{"post":{"operationId":"confirmPayment","summary":"Confirm a Lightning or Stripe checkout payment","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/confirm_payment_input"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}},"security":[{"bearer":[]}]}},"/introductions":{"post":{"operationId":"requestIntroduction","summary":"Free introduction request","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_introduction_input"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/orders/warm-intro":{"post":{"operationId":"orderWarmIntro","summary":"Paid warm intro to a co-founder profile","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/order_warm_intro_input"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}},"security":[{"bearer":[]}]}},"/orders/shortlist":{"post":{"operationId":"orderShortlist","summary":"Paid co-founder shortlist","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/order_shortlist_input"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}},"security":[{"bearer":[]}]}},"/alerts":{"post":{"operationId":"setAlerts","summary":"Weekly e-mail alerts","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/set_alerts_input"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}},"security":[{"bearer":[]}]}},"/requests/{id}":{"get":{"operationId":"getRequestStatus","summary":"Status of a request (CFI-…, with ?email=) or an order (with api_key)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"email","in":"query","required":false,"description":"E-mail used in the request","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"API key missing or invalid"},"402":{"description":"Payment required (x402 / L402 / credits)"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}}}}