API · Manage · Compliance
List state registrations.
List the entity's state-level registrations (employer, sales tax, DBA, business license). Filter by registration_kind, state, and status (pending | confirmed | lapsed | withdrawn). Cursor-paginated.
Last updated
Query Parameters
registration_kindstringOptionalOne of
"employer""sales_tax""dba""business_license"statestringOptionalstatusstringOptionalOne of
"pending""confirmed""lapsed""withdrawn"Response Body
application/json
Request
curl -X GET "https://api.mattermode.com/v1/entities/{id}/state_registrations"fetch("https://api.mattermode.com/v1/entities/{id}/state_registrations", { method: "GET"})package mainimport ( "fmt" "net/http" "io/ioutil")func main() { url := "https://api.mattermode.com/v1/entities/{id}/state_registrations" req, _ := http.NewRequest("GET", url, nil) res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body))}import requestsheaders = { "Authorization": "Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc", "Matter-Version": "2026-06-10",}resp = requests.get( "https://api.mattermode.com/v1/entities/ent_Nq3KcAbc/state_registrations", headers=headers,)resp.raise_for_status()print(resp.json())import java.net.URI;import java.net.http.HttpClient;import java.net.http.HttpRequest;import java.net.http.HttpResponse;import java.net.http.HttpResponse.BodyHandlers;import java.time.Duration;HttpClient client = HttpClient.newBuilder() .connectTimeout(Duration.ofSeconds(10)) .build();HttpRequest.Builder requestBuilder = HttpRequest.newBuilder() .uri(URI.create("https://api.mattermode.com/v1/entities/{id}/state_registrations")) .GET() .build();try { HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString()); System.out.println("Status code: " + response.statusCode()); System.out.println("Response body: " + response.body());} catch (Exception e) { e.printStackTrace();}using System;using System.Net.Http;using System.Text;var client = new HttpClient();var response = await client.GetAsync("https://api.mattermode.com/v1/entities/{id}/state_registrations");var responseBody = await response.Content.ReadAsStringAsync();curl --request GET 'https://api.mattermode.com/v1/entities/ent_Nq3KcAbc/state_registrations' \ --header 'Authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc' \ --header 'Matter-Version: 2026-06-10'const response = await fetch("https://api.mattermode.com/v1/entities/ent_Nq3KcAbc/state_registrations", { method: "GET", headers: { "Authorization": "Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc", "Matter-Version": "2026-06-10", },});if (!response.ok) { throw new Error(`Matter API ${response.status}: ${await response.text()}`);}const data = await response.json();console.log(data);Response
200List of state registrations.
application/json{
"object": "list",
"has_more": true,
"url": "/v1/entities",
"next_cursor": "cur_PqB5fG7K",
"data": [
{
"object": "state_registration",
"id": "string",
"entity_id": "string",
"registration_kind": "employer",
"agency": null,
"agency_account_kind": null,
"jurisdiction": {
"state": "string",
"county": "string",
"city": "string"
},
"status": "pending",
"effective_date": "2019-08-24",
"confirmed_at": "2019-08-24T14:15:22Z",
"closed_at": "2019-08-24T14:15:22Z",
"closure_status": {
"initiated_at": "2019-08-24T14:15:22Z",
"initiated_by": "string",
"authorizing_resolution_id": "string",
"target_terminal_state": "closed",
"sub_account_progress": [
{
"agency": "string",
"agency_account_kind": "string",
"state_account_number": "string",
"status": "pending_final_filings",
"blocker_summary": "string",
"clearance_filing_id": "string",
"final_return_filing_ids": [
"string"
],
"expected_clearance_at": "2019-08-24",
"closed_at": "2019-08-24T14:15:22Z"
}
],
"blocked_summary": "string",
"terminal_at": "2019-08-24T14:15:22Z"
},
"state_account_number": "string",
"trade_name": "string",
"trigger": null,
"registered_agent_partner_id": "string",
"obligations": [
{
"form_code": "string",
"period_kind": "monthly",
"due_at": "2019-08-24",
"agency": "string",
"filing_id": "string"
}
]
}
]
}