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

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

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

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