---
title: "POST /v2/exchangeSet/s100/productNames"
method: POST
path: "/v2/exchangeSet/s100/productNames"
tags: ["public"]
---

# POST /v2/exchangeSet/s100/productNames

`POST /v2/exchangeSet/s100/productNames`

Given a list of Product names, return all the products that are releasable.

**Business Rules:**

Only Products that are releasable at the date of the request will be returned.

If valid Products are requested then Product exchange set with baseline data including requested Products will be returned.

If a requested Product has been cancelled or replaced, then the replacement Product will not be included in the response payload. Only the specific Products requested will be returned.

If none of the Products requested exist then exchange set with baseline releasable data without requested Products will be returned.

## Query parameters

- `callbackUri` string

## Headers

- `X-Correlation-ID` string, required

## Request body

- string[]

## Response `202`

Request to create Exchange Set is accepted. Response body has Exchange Set status URL to track changes to the status of the task. It also contains the URL that the Exchange Set will be available on as well as the number of products in that Exchange Set.

 If none of the requested products are available, then status code 202 ('Accepted') will be returned with an empty Exchange Set and the exchangeSetProductCount will be 0.

If a requested Product has been cancelled or replaced, then the replacement Product will not be included in the response payload. Only the specific Products requested will be returned.

- CustomExchangeSetResponse
  - `links` ExchangeSetLinks, required
    - `exchangeSetBatchStatusUri` Link, required
      - `uri` string, uri, required
    - `exchangeSetBatchDetailsUri` Link, required
      - `uri` string, uri, required
    - `exchangeSetFileUri` Link2, nullable
      - `uri` string, uri, required
  - `exchangeSetUrlExpiryDateTime` string, date-time
  - `requestedProductCount` unknown
  - `exchangeSetProductCount` unknown
  - `requestedProductsAlreadyUpToDateCount` unknown
  - `requestedProductsNotInExchangeSet` unknown
  - `fssBatchId` unknown

## Other responses

- `400` — Bad Request. In case of a malformed request, only the HTTP status code will be returned without an error body.
- `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/s100-exchange-set-service-api.md) · [All operations](https://skmtc.net/uk-hydrographic-office/apis/s100-exchange-set-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uk-hydrographic-office/s100-exchange-set-service-api/revisions/4f2e5a0c4400/schema)