# Get a list of instances

Returns information about instances owned by a producer's customer accounts.  
Each customer account may have one or more instances, and each instance serves 
exactly one customer account.


Endpoint: GET /v1.0/instances
Version: 1.0
Security: AdministrationAccess

## Query parameters:

  - `next` (integer)
    Enter the next page value returned by the response to the previous GET /instances request to get the next page of instances.

  - `size` (string)
    Enter the number of items to return. (This number of items is not guaranteed.)

  - `accountId` (string)
    Find instances belonging to this account ID. This query parameter must be used in combination with the 'default' query parameter.

  - `default` (boolean)
    Find the default instance for the given account ID. Must be set to 'true'.

## Response 200 fields (application/json):

  - `content` (array)
    The list of instances.

  - `content.id` (string)
    The ID of the instance.

  - `content.shortName` (string, required)
    User-defined name of the instance.

  - `content.accountId` (string, required)
    ID of the customer account owning the instance.

  - `content.defaultInstance` (boolean)
    Indicates whether this is the default instance for an account. If
set to true, auto-provisioned line items will be mapped to this
instance.

  - `content.created` (integer)
    The date and time the instance was created in milliseconds since 1970-01-01 00:00.

  - `content.modified` (integer)
    The date and time the instance was last modified in milliseconds since 1970-01-01 00:00.

  - `next` (integer)
    Use this page value in your next GET /instances request to fetch the next page of instances.