Limited AvailabilityAccess to the Compliance API is currently limited to approved partners. Endpoints, request/response shapes, and field names may change before reaching general availability — use against staging for early integration work and coordinate with your CorpNet account manager before relying on Compliance API calls in production-critical paths. Report issues or feedback to your account manager.
GET /v1/partners/{partnerId}/alertsReturns open compliance alert opportunities (Annual Report, Registered Agent renewal, BOI report, etc.) for your partner account, with associated form data already prefilled from each entity's records. Use this as the discovery endpoint for what compliance actions are pending across your book of business.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
partnerId | String | Yes | Your Account PID. |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
companyId | String | No | Filter to alerts for a single company. |
type | String | No | Filter by alert type (e.g., Registered Agent, Annual Report). URL-encode spaces. |
Example
curl -s \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
"https://api.corpnet.com/v1/partners/P123456/alerts?companyId=a0EVB00000GPzIP2A1&type=Registered%20Agent"Response — 200 OK
200 OK
Envelope noteThis endpoint returns
{ "opportunities": [...] }at the top level — it does not use the standard{ "data": ... }envelope. Plan parsing accordingly.
{
"opportunities": [
{
"id": "006VB00000K3al0YAB",
"name": "Registered Agent - DE - Sample Company LLC",
"serviceCategory": "Registered Agent",
"closeDate": "2025-12-31",
"amount": 149.00,
"stageName": "Prospecting",
"entityName": "Sample Company LLC",
"state": "DE",
"entityId": "a0EVB00000GPzIP2A1",
"complianceForms": [
{
"formDataId": "a0FVB00000ABC123",
"formDefinitions": [
{
"formDefinitionName": "RA_DE_Form",
"formDefinitionId": "a0GVB00000DEF456",
"formTitle": "Delaware Registered Agent",
"statePicklist": "DE",
"version": "1.0",
"sections": {
"EntityState": {
"Filed_Qualification_Date": "2020-05-15",
"EntityNumber": "7654321"
},
"FranchiseTaxInformation": {
"CountofCommonStockShares": "1000",
"CountofPreferredStockShares": "0"
},
"root": {
"ForeignQualified": false
}
}
}
]
}
],
"opportunityProducts": [
{
"id": "00kVB00000GHI789",
"totalPrice": 149.00,
"listPrice": 149.00,
"unitPrice": 149.00,
"quantity": 1,
"productName": "Delaware Registered Agent Service",
"productFamily": "Compliance"
}
]
}
]
}Compliance Forms Structure
| Field | Description |
|---|---|
formDataId | Identifier for the form data record. Pass this back to Submit Compliance Form Data when posting the completed form. |
formDefinitions | Array of form definitions tied to this alert (typically one per alert). |
formDefinitionId | Identifier of the form definition (template). Pass this back when submitting. |
sections | Field values grouped by section name. Field names without a section prefix appear under root. |
No Results
{ "opportunities": [] }A 200 with an empty opportunities array means "no open alerts," not an error.
Error Responses
{ "statusCode": 400, "message": "No account found for the provided PID." }{ "statusCode": 403, "message": "User does not have access to this account" }Notes
- The
complianceFormsarray contains prefilled fields drawn from each entity's records — present these to your customer for review and updates, then submit via Submit Compliance Form Data. - For full detail on a single alert (additional fields not in the list view), use Get a Compliance Alert.