List Subscriptions

🚧
Limited Availability
Access 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}/subscriptions

Returns subscription plan records for the partner — Registered Agent, Annual Report, and other recurring compliance services. Supports optional filters by company or specific subscription plan.

Path Parameters

Parameter	Type	Required	Description
`partnerId`	String	Yes	Your Account PID.

Query Parameters

Parameter	Type	Required	Description
`companyId`	String	No	Filter to subscriptions for a single company.
`serviceId`	String	No	Filter to a specific subscription plan by its identifier.

Example

curl -s \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  "https://api.corpnet.com/v1/partners/P123456/subscriptions?companyId=a0AXXXXXXXXXXXX"

Response — `200 OK`

{
  "data": {
    "companyName": null,
    "subscriptions": [
      {
        "id": "a0S5e000001ABCD",
        "entityId": "a0A5e000002abcd",
        "state": "CA",
        "renewalType": "Auto Renewal",
        "startDate": "2025-01-01",
        "endDate": "2025-12-31",
        "orderId": "801XXXXXXXXXXXX",
        "entityName": "ABC Company Inc",
        "serviceCategory": "AnnualReport",
        "autoRenewDate": "2025-12-01"
      },
      {
        "id": "a0S5e000001EFGH",
        "entityId": "a0A5e000002efgh",
        "state": "DE",
        "renewalType": "Manual",
        "startDate": "2025-01-01",
        "endDate": "2025-12-31",
        "orderId": "801YYYYYYYYYYYYY",
        "entityName": "XYZ Corporation",
        "serviceCategory": "RegisteredAgent",
        "autoRenewDate": null
      }
    ]
  },
  "statusCode": 200,
  "message": "Success"
}

Response Fields

Field	Type	Description
`data.companyName`	String	Company name when `companyId` is specified; otherwise `null`.
`data.subscriptions`	Array	Subscription plan records.
`subscriptions[].id`	String	Subscription Plan identifier (`subscriptionId`). Use in Get a Subscription, Cancel a Subscription, and Renew a Subscription.
`subscriptions[].entityId`	String	Company identifier this subscription belongs to.
`subscriptions[].state`	String	Two-letter state code where the service applies.
`subscriptions[].renewalType`	String	`Auto Renewal` or `Manual`.
`subscriptions[].startDate`	String	Term start (`YYYY-MM-DD`).
`subscriptions[].endDate`	String	Term end (`YYYY-MM-DD`).
`subscriptions[].orderId`	String	Order identifier that fulfilled this subscription.
`subscriptions[].entityName`	String	Display name of the company.
`subscriptions[].serviceCategory`	String	Service category: `RegisteredAgent`, `AnnualReport`, etc.
`subscriptions[].autoRenewDate`	String \| null	Next auto-renew date if `renewalType` is `Auto Renewal`; `null` otherwise.

No Subscriptions

{ "data": null }

A 200 with data: null means "no subscriptions found for this partner / filter combination," not an error.

Limited Availability

Path Parameters

Query Parameters

Example

Response — 200 OK

Response Fields

No Subscriptions

Response — `200 OK`