# findPiece

> **findPiece**(`options`): [`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`PieceLink`\>

Defined in: [packages/synapse-core/src/sp/sp.ts:454](https://github.com/FilOzone/synapse-sdk/blob/7fdc04df4e3c52366a9f0cd55da4c05e20b2ed82/packages/synapse-core/src/sp/sp.ts#L454)

Find a piece on the PDP API.

GET /pdp/piece?pieceCid={pieceCid}

## Parameters

| Parameter | Type | Description |
| ------ | ------ | ------ |
| `options` | [`OptionsType`](/reference/filoz/synapse-core/sp/namespaces/findpiece/type-aliases/optionstype/) | [findPiece.OptionsType](/reference/filoz/synapse-core/sp/namespaces/findpiece/type-aliases/optionstype/) |

## Returns

[`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`PieceLink`\>

Piece CID [findPiece.OutputType](/reference/filoz/synapse-core/sp/namespaces/findpiece/type-aliases/outputtype/)

## Throws

Errors [findPiece.ErrorType](/reference/filoz/synapse-core/sp/namespaces/findpiece/type-aliases/errortype/)