{
  "openapi": "3.1.0",
  "info": {
    "title": "FundedIQ API",
    "version": "1.0.0",
    "description": "Recently funded startups: companies, rounds, investors and founder contacts. 60,745 funded companies and 83,046 funding rounds covering rounds from 2020-02-02 to 2026-08-21, refreshed weekly.\n\nMetered in credits (2,000 a month on Pro). Search costs 1 credit per call; unlocking a company costs 1 credit; filters and account are free.",
    "contact": {
      "url": "https://fundediq.co/docs/api/"
    }
  },
  "servers": [
    {
      "url": "https://fundediq.co/api/v1"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/account": {
      "get": {
        "operationId": "account",
        "summary": "Account and credit balance",
        "description": "Plan, subscription status, remaining credits, when the credit period resets, and what each call costs. Call it before a large batch instead of discovering the balance by running out.\n\nCost: Free",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "email": "you@example.com",
                    "plan": "pro",
                    "status": "active",
                    "onTrial": false,
                    "credits": {
                      "total": 2000,
                      "used": 61,
                      "remaining": 1939
                    },
                    "periodEnd": "2026-09-17T00:00:00+00:00",
                    "trialEnd": null,
                    "endsAt": null,
                    "rates": {
                      "search": 1,
                      "unlockPerCompany": 1,
                      "filters": 0,
                      "account": 0
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credits; nothing was charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "The key is not on a Pro subscription",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited; see the Retry-After header",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/filters": {
      "get": {
        "operationId": "filters",
        "summary": "Filter values",
        "description": "Every value the industry, country, city, round-type and employee-band filters accept, with the number of companies behind each. Filters match exact strings, so read them here rather than guessing: a guessed spelling returns an empty result that looks exactly like a real one.\n\nCost: Free",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "industries": [
                      {
                        "value": "Artificial Intelligence, Machine Learning",
                        "companyCount": 4812
                      },
                      {
                        "value": "SaaS",
                        "companyCount": 3990
                      }
                    ],
                    "countries": [
                      {
                        "value": "United States",
                        "companyCount": 31204
                      }
                    ],
                    "cities": [
                      {
                        "value": "San Francisco",
                        "companyCount": 4771
                      }
                    ],
                    "rounds": [
                      {
                        "value": "Seed",
                        "companyCount": 18033
                      }
                    ],
                    "sizes": [
                      {
                        "value": "11-50",
                        "companyCount": 21447
                      }
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credits; nothing was charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "The key is not on a Pro subscription",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited; see the Retry-After header",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/companies": {
      "get": {
        "operationId": "search",
        "summary": "Search companies",
        "description": "Filter the database and get company profiles back, with the latest round and counts of how many investors and founder contacts each company has. Those counts are what let an agent decide what is worth unlocking before it spends anything.\n\nCost: 1 credit per call, whatever the page size. A search that matches nothing is free.",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "example": {
                  "data": [
                    {
                      "domain": "northwind.io",
                      "company": "Northwind",
                      "description": "Freight routing for mid-market shippers.",
                      "industry": "Logistics",
                      "country": "United States",
                      "state": "California",
                      "city": "San Francisco",
                      "employeeRange": "11-50",
                      "foundedYear": 2021,
                      "totalRaisedUsd": 18500000,
                      "roundCount": 2,
                      "latestRound": {
                        "date": "2026-08-17",
                        "type": "Series A",
                        "amountUsd": 14000000
                      },
                      "investorCount": 3,
                      "contactCount": 2,
                      "url": "https://fundediq.co/northwind-northwind-io-funding/",
                      "locked": [
                        "investors",
                        "contacts",
                        "rounds",
                        "linkedin",
                        "monthlyVisits",
                        "jobOpenings",
                        "itSpendUsd"
                      ]
                    }
                  ],
                  "meta": {
                    "total": 1284,
                    "page": 1,
                    "pageSize": 100,
                    "returned": 100,
                    "hasMore": true,
                    "credits": {
                      "charged": 1,
                      "balance": 1938
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credits; nothing was charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "The key is not on a Pro subscription",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited; see the Retry-After header",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "description": "Keyword search over company name and description.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "industries",
            "in": "query",
            "description": "Exact industry values. Repeat the parameter for several. Values may themselves contain commas, so they are never comma-split.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": true
          },
          {
            "name": "countries",
            "in": "query",
            "description": "Exact country values.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": true
          },
          {
            "name": "cities",
            "in": "query",
            "description": "Exact city values.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": true
          },
          {
            "name": "rounds",
            "in": "query",
            "description": "Latest round type.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": true
          },
          {
            "name": "sizes",
            "in": "query",
            "description": "Employee band.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": true
          },
          {
            "name": "dateFrom",
            "in": "query",
            "description": "Earliest latest-round date (YYYY-MM-DD).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "dateTo",
            "in": "query",
            "description": "Latest latest-round date (YYYY-MM-DD).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "amountMin",
            "in": "query",
            "description": "Minimum total raised, in whole US dollars.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "amountMax",
            "in": "query",
            "description": "Maximum total raised, in whole US dollars.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "foundedFrom",
            "in": "query",
            "description": "Founded in this year or later.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "hasContacts",
            "in": "query",
            "description": "Only companies with at least one founder contact on file.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "hasInvestors",
            "in": "query",
            "description": "Only companies with at least one named investor on file.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "recent (default), oldest, amount_desc, total_desc, company_asc.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "1-based page number.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "Rows per page, up to 100. Default 50. A call costs the same at 1 row as at 100, so ask for more rows rather than more pages.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "includeFacets",
            "in": "query",
            "description": "Also return value counts per filter dimension.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "example": {
                "countries": [
                  "United States"
                ],
                "industries": [
                  "Logistics"
                ],
                "dateFrom": "2026-08-01",
                "amountMin": 5000000,
                "hasContacts": true,
                "pageSize": 100
              }
            }
          }
        }
      },
      "post": {
        "operationId": "searchByBody",
        "summary": "Search companies",
        "description": "Filter the database and get company profiles back, with the latest round and counts of how many investors and founder contacts each company has. Those counts are what let an agent decide what is worth unlocking before it spends anything.\n\nCost: 1 credit per call, whatever the page size. A search that matches nothing is free.",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "example": {
                  "data": [
                    {
                      "domain": "northwind.io",
                      "company": "Northwind",
                      "description": "Freight routing for mid-market shippers.",
                      "industry": "Logistics",
                      "country": "United States",
                      "state": "California",
                      "city": "San Francisco",
                      "employeeRange": "11-50",
                      "foundedYear": 2021,
                      "totalRaisedUsd": 18500000,
                      "roundCount": 2,
                      "latestRound": {
                        "date": "2026-08-17",
                        "type": "Series A",
                        "amountUsd": 14000000
                      },
                      "investorCount": 3,
                      "contactCount": 2,
                      "url": "https://fundediq.co/northwind-northwind-io-funding/",
                      "locked": [
                        "investors",
                        "contacts",
                        "rounds",
                        "linkedin",
                        "monthlyVisits",
                        "jobOpenings",
                        "itSpendUsd"
                      ]
                    }
                  ],
                  "meta": {
                    "total": 1284,
                    "page": 1,
                    "pageSize": 100,
                    "returned": 100,
                    "hasMore": true,
                    "credits": {
                      "charged": 1,
                      "balance": 1938
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credits; nothing was charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "The key is not on a Pro subscription",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited; see the Retry-After header",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "example": {
                "countries": [
                  "United States"
                ],
                "industries": [
                  "Logistics"
                ],
                "dateFrom": "2026-08-01",
                "amountMin": 5000000,
                "hasContacts": true,
                "pageSize": 100
              }
            }
          }
        }
      }
    },
    "/companies/unlock": {
      "post": {
        "operationId": "unlock",
        "summary": "Unlock full records",
        "description": "Investor names, every funding round with its announcement URL, founders and executives with emails and LinkedIn, company LinkedIn, monthly traffic, open roles and IT spend, for up to 100 companies in one call. A company already unlocked in the current billing period is free, including one unlocked in the web app.\n\nCost: 1 credit per company. 0 for a company already unlocked this period.",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "example": {
                  "data": [
                    {
                      "domain": "northwind.io",
                      "company": "Northwind",
                      "description": "Freight routing for mid-market shippers.",
                      "industry": "Logistics",
                      "country": "United States",
                      "state": "California",
                      "city": "San Francisco",
                      "employeeRange": "11-50",
                      "foundedYear": 2021,
                      "totalRaisedUsd": 18500000,
                      "roundCount": 2,
                      "latestRound": {
                        "date": "2026-08-17",
                        "type": "Series A",
                        "amountUsd": 14000000
                      },
                      "investorCount": 3,
                      "contactCount": 2,
                      "url": "https://fundediq.co/northwind-northwind-io-funding/",
                      "investors": [
                        "Union Square Ventures",
                        "Bessemer",
                        "Craft"
                      ],
                      "rounds": [
                        {
                          "date": "2026-08-17",
                          "type": "Series A",
                          "amountUsd": 14000000,
                          "announcementUrl": "https://www.crunchbase.com/funding_round/example"
                        },
                        {
                          "date": "2024-03-05",
                          "type": "Seed",
                          "amountUsd": 4500000,
                          "announcementUrl": null
                        }
                      ],
                      "contacts": [
                        {
                          "name": "Dana",
                          "title": "Co-founder & CEO",
                          "email": "dana@northwind.io",
                          "emailConfidence": "verified",
                          "linkedin": "https://www.linkedin.com/in/example"
                        }
                      ],
                      "linkedin": "https://www.linkedin.com/company/example",
                      "monthlyVisits": 41200,
                      "monthlyVisitsGrowthPct": 12.4,
                      "jobOpenings": 6,
                      "itSpendUsd": null
                    }
                  ],
                  "meta": {
                    "requested": 1,
                    "unlocked": 1,
                    "notFound": [],
                    "credits": {
                      "charged": 1,
                      "alreadyHeld": 0,
                      "balance": 1937
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credits; nothing was charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "The key is not on a Pro subscription",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited; see the Retry-After header",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "domains": [
                  "northwind.io"
                ]
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "An API key from https://fundediq.co/account/#api. Starts with `fiq_sk_`."
      }
    },
    "schemas": {
      "Company": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Bare hostname. The stable identifier."
          },
          "company": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "industry": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "state": {
            "type": [
              "string",
              "null"
            ]
          },
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "employeeRange": {
            "type": [
              "string",
              "null"
            ],
            "description": "Band, e.g. \"11-50\". Not a number."
          },
          "foundedYear": {
            "type": [
              "integer",
              "null"
            ]
          },
          "totalRaisedUsd": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Whole US dollars."
          },
          "roundCount": {
            "type": "integer"
          },
          "latestRound": {
            "type": "object",
            "properties": {
              "date": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date"
              },
              "type": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "amountUsd": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            }
          },
          "investorCount": {
            "type": "integer",
            "description": "How many named investors an unlock would return."
          },
          "contactCount": {
            "type": "integer",
            "description": "How many founder/executive contacts an unlock would return."
          },
          "url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Public FundedIQ page for the company."
          },
          "locked": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Fields this record is withholding. Unlock to receive them."
          }
        }
      },
      "UnlockedCompany": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Company"
          },
          {
            "type": "object",
            "properties": {
              "investors": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "rounds": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "date": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date"
                    },
                    "type": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "amountUsd": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "announcementUrl": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                }
              },
              "contacts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "title": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "email": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "emailConfidence": {
                      "type": "string",
                      "enum": [
                        "verified",
                        "risky",
                        "undeliverable",
                        "unknown"
                      ]
                    },
                    "linkedin": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                }
              },
              "linkedin": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "monthlyVisits": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "monthlyVisitsGrowthPct": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "jobOpenings": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "itSpendUsd": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          }
        ]
      },
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "missing_api_key",
                  "invalid_api_key",
                  "pro_required",
                  "no_subscription",
                  "insufficient_credits",
                  "not_found",
                  "too_many_domains",
                  "rate_limited"
                ]
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "code",
              "message"
            ]
          }
        }
      }
    }
  }
}