Authentication

Every request to the Fundz API is authenticated. Send your API key in the Authorization header on a paid plan, and you're ready to call any endpoint. This page covers getting a key, the base URL, the response envelope, pagination, query limits, and error handling.

🚀 Quick Start

Pass your key in the Authorization header on any request:

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/fundings?series=seed&created_from=2026-01-01"

Base URL

All API requests are made to:

https://api.fundz.net

Getting an API Key

The Fundz API is available on paid plans only — there is no free API tier. To get a key, subscribe to a Pro or Strategic plan and request API access from your account, or contact our team for partner / data-licensing access.

An inactive or expired subscription returns 401 with a message pointing to fundz.net/pricing.

Authenticating Requests

Send your key in the Authorization header. This is the standard method for partner / API usage:

Authorization: YOUR_API_KEY

A full request looks like:

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/companies/onelayer"

Response Envelope

List / feed endpoints return a consistent envelope: a data array of records (each serialized by that resource's schema — see Data Models), a meta object with pagination and plan info, and an upgrade_url.

{
  "data": [ /* array of records, serialized by that resource's schema */ ],
  "meta": {
    "current_page": 1,
    "next_page": 2,
    "total_count": 1234,
    "total_pages": 50,
    "tier": "Pro",
    "remaining_searches": 97
  },
  "upgrade_url": "https://www.fundz.net/pricing"
}

When a query returns nothing, the response also includes a guidance object with a message and suggestions — and that query does not count against your limit.

Pagination

List endpoints return 25 records per page. Use ?page=N to page through results; meta.current_page, meta.next_page, meta.total_count, and meta.total_pages tell you where you are.

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/fundings?page=2"

Query Limits

Query limits vary by plan. Every list response tells you what you have left:

When the limit is reached, the API returns 429 with the current tier and an upgrade_url. Don't hardcode exact per-plan numbers — read meta.remaining_searches instead.

Errors

Errors are returned as JSON with a type and a human-readable message:

{
  "error": "Unauthorized",
  "message": "Authentication required"
}

Need Help?

Our team is here to help you get the most out of the Fundz API.