# findPiece

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

Defined in: [packages/synapse-core/src/sp.ts:624](https://github.com/FilOzone/synapse-sdk/blob/32f86959b0bf15557657ea412e31a0897440ca98/packages/synapse-core/src/sp.ts#L624)

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.ReturnType](/reference/filoz/synapse-core/sp/namespaces/findpiece/type-aliases/returntype/)

## Throws

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