Get a Company

🚧

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}/companies/{companyId}

Returns a single company with expanded detail: basic identifiers, open compliance alerts, historical orders, state-by-state entity status, members, affiliations, tax registrations, and outstanding tasks. Use this when you need the full picture for one entity.

Path Parameters

ParameterTypeRequiredDescription
partnerIdStringYesYour Account PID.
companyIdStringYesCompany identifier (returned by List Companies or Create a Company).

Example

curl -s \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  "https://api.corpnet.com/v1/partners/P123456/companies/a0A5e000002abcd"

Response — 200 OK

The response wraps everything under data and groups detail into named sub-objects.

{
  "data": {
    "entityBasic": {
      "id": "a0A5e000002abcd",
      "name": "ABC Company Inc",
      "formationDate": "2020-01-15",
      "type": "LLC",
      "ein": "12-3456789",
      "filingnumber": "C1234567",
      "homeState": "CA",
      "numberOfOrders": 5,
      "numberOfAlerts": 2,
      "numberOfLocations": 1,
      "businessDescription": "Technology consulting services",
      "buisnessCategory": "Professional Services",
      "website": "https://www.abccompany.com",
      "businessAddress": { /* … street, city, state, zip, country */ },
      "accessLevel": "Write",
      "companyManagment": "Active"
    },
    "complianceAlerts": [
      {
        "id": "006VB00000K3al0YAB",
        "name": "Registered Agent - DE - ABC Company Inc",
        "serviceCategory": "Registered Agent",
        "closeDate": "2026-12-31",
        "amount": 149.00,
        "status": "Prospecting",
        "companyName": "ABC Company Inc",
        "serviceState": "CA",
        "companyId": "a0A5e000002abcd",
        "alertType": "Registered Agent",
        "alertBody": "Your registered agent service is due for renewal.",
        "alertActualDueDate": "2026-12-31"
      }
    ],
    "orders": [
      {
        "id": "801XXXXXXXXXXXX",
        "uid": "UID-12345",
        "orderNumber": "00001234",
        "status": "Completed",
        "orderDate": "2025-06-15",
        "completionDate": "2025-06-20",
        "amount": 149.00,
        "serviceCategory": "Registered Agent",
        "companyName": "ABC Company Inc",
        "entityType": "LLC"
      }
    ],
    "states": [
      {
        "id": "a0B5e000001XXXX",
        "stateName": "California",
        "stateAbv": "CA",
        "beganOperations": "2020-01-15",
        "foreignQualified": "false",
        "primary": true,
        "locations": [],
        "dba": [],
        "registeredAgent": {
          "id": "a0C5e000001YYYY",
          "fullName": "CorpNet Inc",
          "agentAddress": {
            "street": "910 Faulkner Ct",
            "city": "Brea",
            "state": "CA",
            "zip": "92821"
          }
        },
        "businessLicenses": []
      }
    ],
    "entityMembers": [],
    "entityAffiliations": [],
    "taxRegistrations": [],
    "tasks": []
  },
  "statusCode": 200,
  "message": "Success"
}

Top-Level Objects

ObjectDescription
entityBasicSame shape as a list entry from List Companies.
complianceAlertsOpen compliance alerts for this company. Same shape as entries returned by List Compliance Alerts.
ordersHistorical orders associated with this company.
statesState-by-state entity registration detail (foreign qualification, registered agent assignment, locations, DBAs, business licenses).
entityMembersMembers / officers on record.
entityAffiliationsRelated-entity affiliations.
taxRegistrationsEmployer tax registrations on file.
tasksOutstanding compliance tasks.

Notes

  • Empty sub-objects ([]) indicate "no records," not "you don't have access." 403 Forbidden is returned at the top level when row-level access is denied.
  • The response is heavy. For lightweight enumeration use List Companies; only call Get-a-Company when you need the expanded detail for a specific entity.