Skip to main content
POST
/
deals
curl --request POST \
  --url https://tryfundable.ai/api/v1/deals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "deal": {
    "financing_types": [
      {
        "type": "SERIES_A"
      },
      {
        "type": "SERIES_B"
      }
    ]
  },
  "page_size": 10
}
'
{
  "success": true,
  "data": {
    "deals": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "company_id": "550e8400-e29b-41d4-a716-446655440001",
        "investor_ids": [
          "c5a3f6ac-f6c9-4686-aa6e-12aeb7419b82"
        ],
        "financings": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "type": "SERIES_A",
            "size_usd": 25000000,
            "size_native": 25000000,
            "currency": "USD"
          }
        ],
        "round_type": "SERIES_A",
        "extension": false,
        "intermediate": "NONE",
        "pre": false,
        "date": "2024-01-15T00:00:00Z",
        "created_at": "2024-01-16T12:30:00Z",
        "total_round_raised": 25000000,
        "deal_descriptions": {
          "short_description": "<string>",
          "long_description": "<string>"
        },
        "valuation": {
          "type": "POST_MONEY",
          "valuation_currency": "USD",
          "valuation_usd": 100000000,
          "valuation_native": 100000000
        },
        "articles": [
          {
            "is_primary": true,
            "link": "https://techcrunch.com/2024/01/15/company-raises-series-a",
            "date": "2024-01-15"
          }
        ]
      }
    ]
  },
  "meta": {
    "total_count": 1547,
    "page": 0,
    "page_size": 10,
    "credits_used": 10,
    "credit_source": "monthly",
    "monthly_credits_remaining": 990,
    "purchased_credits_remaining": 500
  }
}

Authorizations

Authorization
string
header
required

API key authentication using Bearer token format. Format: Authorization: Bearer vg_your_api_key_here

API keys follow the pattern: vg_[12_hex_chars]_[32_base64url_chars]

Body

application/json
identifiers
object

Look up specific deals by identifier

deal
object

Deal attribute filters

company
object

Company attribute filters

investors
object

Filter by investor participation

page
integer
default:0

Page number (0-based)

Required range: x >= 0
page_size
integer
default:10

Number of results per page

Required range: 1 <= x <= 100
sort_by
enum<string>
default:most_recent_deal

Sort order for results

Available options:
most_recent_deal,
oldest_deal,
largest_raise,
smallest_raise

Response

Successful response with deals data

success
boolean
required
Example:

true

data
object
required
meta
object
required