# Get a specific line item by ID

Returns information about a specific line item. Pass the line item ID for which you require information as a path parameter.

Endpoint: GET /provisioning/api/v1.1/instances/{instanceId}/line-items/{lineItemId}
Version: v1.1
Security: AdministrationAccess, ClientAccess

## Security:

  - `AdministrationAccess` (unknown)
    http bearer JWT

  - `ClientAccess` (unknown)
    http bearer JWT

## Path parameters:

  - `instanceId` (string, required)
    The UUID of the Dynamic Monetization instance.

  - `lineItemId` (string, required)
    Line item ID. 
Note: This is also known as the activation ID.

## Response 200:

  - `200` (unknown)
    The requested line item was found and returned successfully.

## Response 200 fields (application/json):

  - `activationId` (string, required)
    The activation ID of a line item that should be mapped to the instance.

  - `state` (string, required)
    The line item state. Valid states are:
- DEPLOYED
- INACTIVE
- OBSOLETE

INACTIVE and OBSOLETE can only be set when the line item already exists.
An OBSOLETE line item cannot be set to INACTIVE or DEPLOYED.

  - `quantity` (integer, required)
    The quantity from the line item to map to the instance.

  - `start` (integer, required)
    The date and time, in milliseconds since 1970-01-01 00:00 UTC, when the line item starts.

  - `end` (integer, required)
    The date and time, in milliseconds since 1970-01-01 00:00 UTC, when the line item ends.

  - `used` (number)
    The count from the line item quantity used by access requests. The value can be fractional.

  - `attributes` (object, required)
    The properties that determine how the service will respond to access requests.

  - `attributes.elastic` (boolean)
    Indicates whether the line item is elastic.

  - `attributes.rateTableSeries` (string)
    The rate table series used to determine the rate applied to Elastic access requests against this line item. An empty string indicates that the rate is determined by the latest version of a table with no series.

  - `attributes.overdraftLimit` (integer)
    Allow requests to continue consuming tokens from this line item after the entitled quantity has been fully consumed, up to the overdraft limit. 
The overdraftType field must be set to "Number" if an overdraft limit is provided.
To consume tokens from this line item indefinitely, set the overdraftType to "Unlimited", and an overdraft limit is not required.
If an overdraft limit is not set, requests can only consume from this line item until the entitled quantity is reached.

  - `attributes.overdraftType` (string)
    The type of overdraft. Valid types are:
- Unlimited
- Number

  - `attributes.resetFrequency` (string)
    Specifies how often the line item’s used count is reset. The reset schedule is applied relative to the line item start date and determines when consumption totals are set back to zero.
The value must be an ISO-8601 duration using exactly one of the following formats:
- PnD — days
- PnW — weeks
- PnM — months
- PnY — years

Note:
- Mixed or compound durations such as P1Y2M, P2M10D, or P1W3D are not allowed.
- The shortest permitted interval is one day (P1D) and the longest is one year (P1Y).
- Day-based durations are treated literally and are not converted into months or years. For example, use P1M for a monthly reset rather than P30D or P31D.
- When a reset frequency is first applied, the next reset point is calculated from the line item start date. Setting or changing the reset frequency does not immediately reset consumption; it only affects the calculation of the next reset boundary.
- When the reset frequency property is removed from a line item, upcoming scheduled reset will not take place. Consumption will not reset automatically until a new reset frequency is applied, and existing usage counts remain unchanged.
    Example: P1M

## Response 400:

  - `400` (unknown)
    Bad Request. Check the request for any errors in the input.

## Response 404:

  - `404` (unknown)
    Resource not found. The requested resource is not available.

## Response 500:

  - `500` (unknown)
    Internal Server Error. There was an internal error processing the request. If you need to contact support, please include the reference number provided in the response.