List all entities

GET /api/v1/entities

Returns a list of your contracting entities. The entities are returned sorted by creation date, with the most recent entities appearing first.

Query parameters

  • limit integer

    A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.

    Minimum value is 1, maximum value is 100. Default value is 10.

Responses

  • • 200 application/json

    Returns an array of entity objects. If no more entities are available, the resulting array will be empty. Returns an error if the entity ID is invalid.

    Hide response attributes Show response attributes object
    • address object
      Hide address attributes Show address attributes
      • country string | null

        2-letter country code.

      • line1 string

        Address line 1 (Street address/PO Box).

      • line2 string | null

        Address line 2 (Apartment/Suite/Unit/Building).

      • locality string

        City/District/Suburb/Town/Village.

      • postalcode string

        ZIP or postal code.

      • region string

        2-letter state code.

    • coverage_limit object

      The contracting entity's minimum required coverage limits.

      Hide coverage_limit attributes Show coverage_limit attributes
      • aggregate_limit integer Required

        The total amount the insurance company will pay for multiple claims over the course of one policy term.

        A positive integer representing the aggregate limit expressed in cents (e.g., 100000000 cents to represent $1,000,000). The minimum amount is 1000 cents US.

      • occurrence_limit integer Required

        The total amount the insurance company will pay per incident during the policy term.

        A positive integer representing the per occurrence limit expressed in cents (e.g., 100000000 cents to represent $1,000,000). The minimum amount is 1000 cents US.

    • created integer(int64)

      Time at which the object was created. Measured in seconds since the Unix epoch.

    • id string
    • name string

      The contracting entity's legal name.

    • required_coverage array[string]

      An array of coverage types that can include one or more of the following insurance coverage values: general, professional and workers-comp.

      Values are general, professional, or workers-comp.
GET /api/v1/entities 
curl \
 -X GET https://api.1099policy.com/api/v1/entities
Response examples (200) 
[
  {
    "address": {
      "line1": "One Apple Park Way",
      "locality": "Cupertino",
      "postalcode": 95014,
      "region": "CA"
    },
    "coverage_limit": {
      "aggregate_limit": 200000000,
      "occurrence_limit": 100000000
    },
    "created": 1646818364,
    "id": "en_Ah3tqYn",
    "name": "Apple, Inc",
    "required_coverage": [
      "general",
      "workers-comp"
    ]
  },
  {
    "address": {
      "line1": "410 Terry Ave N",
      "locality": "Seattle",
      "postalcode": 98109,
      "region": "WA"
    },
    "coverage_limit": {
      "aggregate_limit": 500000000,
      "occurrence_limit": 100000000
    },
    "created": 1646818386,
    "id": "en_Mg5sqSp",
    "name": "Amazon, Inc",
    "required_coverage": [
      "general",
      "professional"
    ]
  }
]