# 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:455](https://github.com/FilOzone/synapse-sdk/blob/b11ef4f7e3c201d8bba29973a09628063e6547b1/packages/synapse-core/src/sp/sp.ts#L455)

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/)