> For the complete documentation index, see [llms.txt](https://xpansionchain-1.gitbook.io/xpansionchain/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xpansionchain-1.gitbook.io/xpansionchain/guides/basic-guides/get-data/projects.md).

# Projects

### Projects[​](https://docs.x.immutable.com/docs/x/how-to-get-data#projects) <a href="#projects" id="projects"></a>

This is the only section that requires user signatures - specifically, project owner signatures. This is because only project owners can list projects they own, or get details about each one. Follow <mark style="color:blue;">this guide</mark> to generate the signers required to obtain user signatures.

#### Get list of projects <a href="#get-list-of-projects" id="get-list-of-projects"></a>

* Typescript Core SDK

📚SDK REFERENCE

* <mark style="color:blue;">getProjects</mark>
* Kotlin (JVM) Core SDK
* Swift Core SDK
* Golang Core SDK

#### Request[​](https://docs.x.immutable.com/docs/x/how-to-get-data#request) <a href="#request" id="request"></a>

Get the list of projects belonging to the signer account.

```
const getProjects = async (ethSigner: EthSigner) => {
  const response = await client.getProjects(ethSigner);
  return response;
};

getProjects(ethSigner)
  .then((result) => {
    console.log(result);
  })
  .catch((e) => {
    console.log(e);
  });
```

#### Example response[​](https://docs.x.immutable.com/docs/x/how-to-get-data#example-response) <a href="#example-response" id="example-response"></a>

```
{
  result: [
    {
      id: 145, // The project ID
      name: 'Test writer guild', // The project name
      company_name: 'Test XpansionChain company', // The company name
      contact_email: 'iXpansionChaintest@example.com', // The project contact email
      mint_remaining: 0, // The number of mint operation remaining in the current period
      mint_limit_expires_at: '2022-10-01T17:41:44.650487Z', // The current period expiry date for mint operation limit
      mint_monthly_limit: 0,  // The total monthly mint operation limit
      collection_remaining: 0, // The number of collection remaining in the current period
      collection_limit_expires_at: '2022-10-01T17:41:44.650487Z', // The current period expiry date for collection
      collection_monthly_limit: 0 // The total monthly collection limit
    },
   // Other projects returned
    ...
  ],
  cursor: 'eyJwcm9qZWN0X2lkIjoxNDUsIm5hbWUiOiJUZXN0IHdyaXRlciBndWlsZCIsImNvbXBhbnlfbmFtZSI6IlRlc3QgSW1tdXRhYmxlIGNvbXBhbnkiLCJjb250YWN0X2VtYWlsIjoiaW1tdXRhYmxldGVzdEBleGFtcGxlLmNvbSIsIm1pbnRfcmVtYWluaW5nIjowLCJtaW50X2xpbWl0X2V4cGlyZXNfYXQiOiIyMDIyLTEwLTAxVDE3OjQxOjQ0LjY1MDQ4N1oiLCJtaW50X21vbnRobHlfbGltaXQiOjAsImNvbGxlY3Rpb25fcmVtYWluaW5nIjowLCJjb2xsZWN0aW9uX2xpbWl0X2V4cGlyZXNfYXQiOiIyMDIyLTEwLTAxVDE3OjQxOjQ0LjY1MDQ4N1oiLCJjb2xsZWN0aW9uX21vbnRobHlfbGltaXQiOjB9',
  // Remaining results
  remaining: 0
}
```

Kotlin (JVM) Core SDK

📚SDK REFERENCE

* <mark style="color:blue;">getProjects</mark>

swift core SDK

📚SDK REFERENCE

* <mark style="color:blue;">getProjects</mark>

Golang Core SDK

* <mark style="color:blue;">GetProjects</mark>

📚SDK REFERENCE

#### Get details about a project​ <a href="#get-details-about-a-project" id="get-details-about-a-project"></a>

* Typescript Core SDK

📚SDK REFERENCE

* <mark style="color:blue;">getProject</mark>

#### Request[​](https://docs.x.immutable.com/docs/x/how-to-get-data#request-1) <a href="#request-1" id="request-1"></a>

Get details about a project with a given ID:

```
const getProject = async (ethSigner: EthSigner, id: string) => {
  const response = await client.getProject(ethSigner, id);
  return response;
};
getProject(ethSigner, '145')
  .then((result) => {
    console.log(result);
  })
  .catch((e) => {
    console.log(e);
  });
```

#### Example response[​](https://docs.x.immutable.com/docs/x/how-to-get-data#example-response-1) <a href="#example-response-1" id="example-response-1"></a>

```
{
    id: 145, // The project ID
    name: 'Test writer guild', // The project name
    company_name: 'Test XpansionChain company', // The company name
    contact_email: 'XpansionChaintest@example.com', // The project contact email
    mint_remaining: 0, // The number of mint operation remaining in the current period
    mint_limit_expires_at: '2022-10-01T17:41:44.650487Z', // The current period expiry date for mint operation limit
    mint_monthly_limit: 0,  // The total monthly mint operation limit
    collection_remaining: 0, // The number of collection remaining in the current period
    collection_limit_expires_at: '2022-10-01T17:41:44.650487Z', // The current period expiry date for collection
    collection_monthly_limit: 0 // The total monthly collection limit
}
```

* Kotlin (JVM) Core SDK

📚SDK REFERENCE

* <mark style="color:blue;">getProject</mark>

* Swift Core SDK

📚SDK REFERENCE

* <mark style="color:blue;">getProject</mark>

* Golang Core SDK

SDK REFERENCE

* <mark style="color:blue;">GetProject</mark>

See <mark style="color:blue;">GetProject example</mark> from our SDK repo.