Ga APIecorp.sos.ga.gov ↗
Search Georgia Secretary of State business records and retrieve entity details, officers, registered agents, and filing history via two structured endpoints.
What is the Ga API?
The ecorp.sos.ga.gov API provides access to the Georgia Secretary of State Corporations Division database through 2 endpoints. Use search_businesses to query entities by business name, control number, registered agent, or officer name, and get_business_details to pull full entity records including officers, registered agent address, NAICS codes, formation date, and complete filing history for any Georgia-registered business.
curl -X GET 'https://api.parse.bot/scraper/eecd73b6-2750-47f0-8387-68a8510eccc0/search_businesses?match_type=starts_with&search_type=business_name&search_value=Delta' \ -H 'X-API-Key: $PARSE_API_KEY'
Search the Georgia Secretary of State business database by business name, control number, registered agent name, or officer name. Returns paginated results with 25 records per page. For business name searches, supports starts_with, contains, and exact_match matching. Control number searches ignore the match_type parameter. Pagination requires the page parameter; omitting it returns the first page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results (25 results per page). |
| match_type | string | How to match the search_value against business names. Only applicable when search_type is business_name; ignored for other search types. |
| search_type | string | Type of search to perform. |
| search_valuerequired | string | The search query. For business_name: a business name or partial name. For control_number: the control number (e.g. 'K831943', '25150225'). For registered_agent: the agent's name. For officer: the officer's name. |
{
"type": "object",
"fields": {
"page": "Current page number",
"businesses": "Array of business entities matching the search criteria",
"total_pages": "Total number of pages available",
"total_records": "Total number of matching records"
},
"sample": {
"data": {
"page": 1,
"businesses": [
{
"status": "Active/Compliance",
"business_id": "4564177",
"business_name": "Bold Delta Kappa Foundation Incorporated",
"business_type": "Domestic Nonprofit Corporation",
"control_number": "25150225",
"registered_agent": "John Doe",
"principal_office_address": "134 Waterlace Way, Fayetteville, GA, 30215, USA"
}
],
"total_pages": 57,
"total_records": 1413
},
"status": "success"
}
}About the Ga API
What the API covers
The API mirrors the Georgia Secretary of State's public business search database, covering domestic and foreign corporations, LLCs, nonprofits, and other registered entity types. Every record is keyed to a Georgia SOS control number, which is the stable identifier used across both endpoints.
search_businesses endpoint
search_businesses accepts a required search_value and an optional search_type parameter that controls which field is matched: business_name, control_number, registered_agent, or officer_name. For business name searches, the match_type parameter lets you choose between starts_with, contains, and exact_match behavior. Results are paginated at 25 records per page; use the page parameter to walk through results, and check total_pages and total_records in the response to understand the full result set.
get_business_details endpoint
get_business_details takes a single control_number (e.g., '25150225' or 'K831943') and returns a detailed record. Response fields include business_name, business_type, business_status, formation_date, naics_code, naics_sub_code, a registered_agent object with name, physical_address, and county, an officers array with each officer's name, title, and business_address, and a filing_history array of individual filings each carrying filing_number, filing_date_time, effective_date, and filing_type.
Practical notes
Control numbers can be alphanumeric (letters prefix older entities). To retrieve details for an entity found in search results, pass its control_number directly to get_business_details. Filing history covers all recorded filings for the entity, not just recent ones, making this useful for tracking registration changes, amendments, and annual registration compliance over time.
The Ga API is a managed, monitored endpoint for ecorp.sos.ga.gov — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ecorp.sos.ga.gov changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ecorp.sos.ga.gov API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Verify whether a Georgia business entity is currently active before entering a contract, using the
business_statusfield. - Identify all officers and their titles for a Georgia-registered company during due diligence, using the
officersarray. - Look up the registered agent name and county for a specific entity to determine where legal notices should be served.
- Enumerate all businesses associated with a particular officer or registered agent by searching with
search_typeset toofficer_nameorregistered_agent. - Audit a company's full filing history, including amendment and dissolution filings, using the
filing_historyarray fromget_business_details. - Build a business intelligence dataset of Georgia-registered entities within a specific industry by cross-referencing
naics_codevalues. - Automate compliance checks by periodically querying
get_business_detailsfor known control numbers and monitoring changes tobusiness_status.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the Georgia Secretary of State provide an official developer API for this data?+
What does the search_businesses endpoint return, and how does pagination work?+
search_businesses returns an array of matching business entities along with total_records and total_pages counts. Results are fixed at 25 per page. To retrieve subsequent pages, pass the page integer parameter. The match_type parameter (starts_with, contains, exact_match) only applies when search_type is business_name; it is ignored for other search types.Are businesses from states other than Georgia included?+
Does the API return the actual text or documents from filings in the filing history?+
filing_history array includes filing_number, filing_date_time, effective_date, and filing_type for each filing, but does not return the full document text or PDF content of the filings themselves. You can fork this API on Parse and revise it to add an endpoint that retrieves the actual filing documents where they are publicly accessible.