# 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.


---

# Agent Instructions: 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://xpansionchain-1.gitbook.io/xpansionchain/guides/basic-guides/get-data/projects.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.