> For the complete documentation index, see [llms.txt](https://koneksi.gitbook.io/koneksi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://koneksi.gitbook.io/koneksi-docs/pink-api/pinning/cid-pin.md).

# CID 상태별로 고정(Pin)나열하기

계정에 고정(pin)하도록 요청한 CID의 상태를 프로그래밍 방식으로 확인해야 하는 경우 pinByHash Endpoint를 사용할 수 있습니다. 이 Endpoint를 사용하면 고정(pin)된 CID의 상태 정보를 검색할 수 있습니다.

pinByHash Endpoint에 가능한 "status" 필터는 다음과 같습니다.

* "status" - 고정 대기열에 있는 작업의 상태를 기준으로 필터링합니다(아래 잠재적 상태 참조). 
* "prechecking" - PINK가 핀 요청에 대해 예비 유효성 검사를 실행 중입니다. 
* "searching" - PINK가 IPFS 네트워크에서 회원님의 콘텐츠를 적극적으로 검색하고 있습니다. 콘텐츠가 격리된 경우 다소 시간이 걸릴 수 있습니다. 
* "retrieving" - PINK가 회원님의 콘텐츠를 찾았으며 현재 콘텐츠를 검색하는 중입니다. 
* "expired" - PINK가 IPFS 네트워크를 검색한 지 하루가 지났는데도 콘텐츠를 찾지 못했습니다. 다시 고정하기 전에 콘텐츠가 IPFS 네트워크에서 호스팅되고 있는지 확인하세요. 
* "over\_free\_limit" - 이 개체를 고정하면 무료 티어 한도를 초과하게 됩니다. 콘텐츠를 계속 고정하려면 유료결제를하세요. 
* "over\_max\_size" - 이 항목의 크기가 너무 커서 고정할 수 없습니다. 이 메시지가 표시되면 PINK Team에 문의하여 맞춤형 솔루션을 요청하세요. 
* "invalid\_object" - 고정하려는 객체를 IPFS 노드에서 읽을 수 없습니다. 이 메시지가 표시되면 고정하려는 대상을 찾기위해에 PINK Team에 문의해 주세요. 
* "bad\_host\_node" - 유효하지 않거나 연결할 수 없는 호스트 노드를 제공했습니다. 제공한 모든 호스트 노드가 온라인 상태이고 연결 가능한지 확인하세요.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://koneksi.gitbook.io/koneksi-docs/pink-api/pinning/cid-pin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.