---
title: "Provide ENC information from sales catalog service."
method: POST
path: "/productInformation/productIdentifiers"
---

# Provide ENC information from sales catalog service.

`POST /productInformation/productIdentifiers`

Given a list of ENC name identifiers, return all the versions of the ENCs from sales catalog service.

## Request body

- string[]

## Response `200`

A JSON body that containing the information of ENCs.

- ScsResponse
  - `products` object[], required
    - `productName` string, required — The unique product identifiers
    - `editionNumber` integer, required — The edition number
    - `updateNumbers` integer[], required — an array of update numbers
    - `dates` object[]
      - `updateNumber` integer — The update number, including update 0 if relevant
      - `updateApplicationDate` string, date-time — The update application date for the catalog.031 UADT data field The base cell issue date or, for re-issues, the issue date of the previous update This is optional if not relevant example: "2019-10-27T00:00:00Z"
      - `issueDate` string, date-time — The issue date for the catalog.031 ISDT data field
    - `cancellation` object — The details of the cancellation, if one exists
      - `editionNumber` integer — The edition number of the cancellation, i.e. 0
      - `updateNumber` integer — The cancellation update number
    - `fileSize` integer, required — The total file size in bytes of all the files for this product
    - `ignoreCache` boolean
    - `bundle` object[] — Collection of physical bundles that are associated with the latest update of this product
      - `bundleType` string — Media type of the bundle, which can be one of the following values:- DVD
      - `location` string — DVDs: This field is divided into two subfields delimited by a semi colon. The first subfield contains the media number ID and the second the exchange set number. The Media ID is designated with a M followed by a number. Examples: - base cell: "M1;B3", - updates: "M2;U1"
  - `productCounts` object, required
    - `requestedProductCount` integer — number of products explicitly requested.
    - `returnedProductCount` integer — number of products that have data included in the produced exchange set.
    - `requestedProductsAlreadyUpToDateCount` integer
    - `requestedProductsNotReturned` object[], required — Where a requested product is not included in the return, the product will be listed in the requestedProductNotReturned portion of the response along with a reason. The reason will be one of: * productWithdrawn (the product has been withdrawn from the AVCS service) * invalidProduct (the product is not part of the AVCS Service, i.e. is an invalid or unknown ENC) * noDataAvailableForCancelledProduct (the product has been cancelled, and is beyond the retention period. Cancelled cells within the retention period will be returned with the cancellation data in the exchange set) * duplicateProduct (the product was included in the request more than once)
      - `productName` string, required
      - `reason` 'productWithdrawn' | 'invalidProduct' | 'noDataAvailableForCancelledProduct' | 'duplicateProduct', required

## Other responses

- `400` — Bad request.
- `401` — Unauthorised - either you have not provided any credentials, or your credentials are not recognised.
- `403` — Forbidden - you have been authorised, but you are not allowed to access this resource.
- `429` — You have sent too many requests in a given amount of time. Please back-off for the time in the Retry-After header (in seconds) and try again.
- `500` — Internal Server Error.

---

[API](https://skmtc.net/uk-hydrographic-office/apis/exchange-set-service-ui-api.md) · [All operations](https://skmtc.net/uk-hydrographic-office/apis/exchange-set-service-ui-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uk-hydrographic-office/exchange-set-service-ui-api/versions/352dca757fdd/schema)