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.

  • A cursor for use in pagination. starting_after is an entity ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with en_fOo123, your subsequent call can include starting_after=en_fOo123 in order to fetch the next page of the list.

  • A cursor for use in pagination. ending_before is an entity ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with en_bAr123, your subsequent call can include ending_before=en_bAr123 in order to fetch the previous page of the list.

Responses

  • 200 application/json

    Returns an array of entity objects. If no more entities are available, the resulting array will be empty.

    Hide response attributes Show response attributes object
    • address object
      Hide address attributes Show address attributes object
      • 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.

      • ZIP or postal code.

      • region string

        2-letter state code.

    • The contracting entity's minimum required coverage limits.

      Hide coverage_limit attributes Show coverage_limit attributes object
      • 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)
[
  {
    "id": "en_Ah3tqYn",
    "name": "Apple, Inc",
    "address": {
      "line1": "One Apple Park Way",
      "region": "CA",
      "locality": "Cupertino",
      "postalcode": 95014
    },
    "created": 1646818364,
    "coverage_limit": {
      "aggregate_limit": 200000000,
      "occurrence_limit": 100000000
    },
    "required_coverage": [
      "general",
      "workers-comp"
    ]
  },
  {
    "id": "en_Mg5sqSp",
    "name": "Amazon, Inc",
    "address": {
      "line1": "410 Terry Ave N",
      "region": "WA",
      "locality": "Seattle",
      "postalcode": 98109
    },
    "created": 1646818386,
    "coverage_limit": {
      "aggregate_limit": 500000000,
      "occurrence_limit": 100000000
    },
    "required_coverage": [
      "general",
      "professional"
    ]
  }
]