# findPiece

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

Defined in: [packages/synapse-core/src/sp/find-piece.ts:34](https://github.com/FilOzone/synapse-sdk/blob/f7cf64c2e5ba1e8fffcf44b11f88f3ef7958de8d/packages/synapse-core/src/sp/find-piece.ts#L34)

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