How to get address books?

Process of fetching address books

Address books can fetched based on 2 parameters

  • id - can be satyam@metamask, satyam.eth etc

  • name (optional) - can be name of the particular address books

Call API

Get Address Books

get
Authorizations
Query parameters
idstringOptionalExample: cosmix@fetcch
namestringOptionalExample: cosmix@fetcch
Responses
200Success
application/json
get
GET /v1/address-books HTTP/1.1
Host: sandbox-api.fetcch.xyz
secret-key: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "id": 1,
      "name": "text",
      "addresses": [
        {
          "id": 1,
          "address": "text",
          "chainType": "EVM",
          "name": "text",
          "addressBookId": 1,
          "addressBook": {
            "id": 1,
            "name": "text",
            "addresses": "[Circular Reference]",
            "walletIds": "[Circular Reference]",
            "ownerId": "text",
            "owner": "[Circular Reference]",
            "requests": "[Circular Reference]",
            "createdAt": "2025-07-05T16:03:47.789Z",
            "updatedAt": "2025-07-05T16:03:47.789Z"
          }
        }
      ],
      "walletIds": [
        {
          "id": 1,
          "walletId": "text",
          "wallet": {
            "id": "text",
            "identifier": "text",
            "providerId": "text",
            "provider": "[Circular Reference]",
            "defaultAddress": "text",
            "default": {
              "address": "text",
              "chain": {
                "id": 1,
                "name": "text",
                "symbol": "text",
                "icon": "text",
                "rpc": [
                  "text"
                ],
                "type": "EVM",
                "shortName": "text",
                "infoURL": "text",
                "chainId": 1,
                "updatedAt": "2025-07-05T16:03:47.789Z",
                "createdAt": "2025-07-05T16:03:47.789Z"
              },
              "chainId": 1,
              "isMultisig": false,
              "isSmartContractWallet": false,
              "walletId": {
                "id": 1,
                "name": "text",
                "symbol": "text",
                "icon": "text",
                "rpc": [
                  "text"
                ],
                "type": "EVM",
                "shortName": "text",
                "infoURL": "text",
                "chainId": 1,
                "updatedAt": "2025-07-05T16:03:47.789Z",
                "createdAt": "2025-07-05T16:03:47.789Z"
              },
              "updatedAt": "2025-07-05T16:03:47.789Z",
              "createdAt": "2025-07-05T16:03:47.789Z"
            },
            "secondary": "[Circular Reference]",
            "nonce": 0,
            "currentSignature": "text",
            "previousSignature": "text",
            "isContract": false,
            "syncedAt": "2025-07-05T16:03:47.789Z",
            "createdAt": "2025-07-05T16:03:47.789Z"
          },
          "name": "text",
          "addressBookId": 1,
          "addressBook": {
            "id": 1,
            "name": "text",
            "addresses": "[Circular Reference]",
            "walletIds": "[Circular Reference]",
            "ownerId": "text",
            "owner": "[Circular Reference]",
            "requests": "[Circular Reference]",
            "createdAt": "2025-07-05T16:03:47.789Z",
            "updatedAt": "2025-07-05T16:03:47.789Z"
          },
          "createdAt": "2025-07-05T16:03:47.789Z",
          "updatedAt": "2025-07-05T16:03:47.789Z"
        }
      ],
      "ownerId": "text",
      "owner": {
        "owner": "text",
        "ownerId": "text",
        "ownerIdentity": {
          "id": "text",
          "identifier": "text",
          "providerId": "text",
          "provider": {
            "id": "text",
            "logo": "text",
            "apiKey": "text",
            "delimiter": "text",
            "txHash": "text",
            "registry": "[Circular Reference]",
            "dataSourceId": 1,
            "ownerId": "text",
            "updatedAt": "2025-07-05T16:03:47.789Z",
            "createdAt": "2025-07-05T16:03:47.789Z"
          },
          "defaultAddress": "text",
          "default": {
            "address": "text",
            "chain": {
              "id": 1,
              "name": "text",
              "symbol": "text",
              "icon": "text",
              "rpc": [
                "text"
              ],
              "type": "EVM",
              "shortName": "text",
              "infoURL": "text",
              "chainId": 1,
              "updatedAt": "2025-07-05T16:03:47.789Z",
              "createdAt": "2025-07-05T16:03:47.789Z"
            },
            "chainId": 1,
            "isMultisig": false,
            "isSmartContractWallet": false,
            "walletId": {
              "id": 1,
              "name": "text",
              "symbol": "text",
              "icon": "text",
              "rpc": [
                "text"
              ],
              "type": "EVM",
              "shortName": "text",
              "infoURL": "text",
              "chainId": 1,
              "updatedAt": "2025-07-05T16:03:47.789Z",
              "createdAt": "2025-07-05T16:03:47.789Z"
            },
            "updatedAt": "2025-07-05T16:03:47.789Z",
            "createdAt": "2025-07-05T16:03:47.789Z"
          },
          "secondary": [
            "[Circular Reference]"
          ],
          "nonce": 0,
          "currentSignature": "text",
          "previousSignature": "text",
          "isContract": false,
          "syncedAt": "2025-07-05T16:03:47.789Z",
          "createdAt": "2025-07-05T16:03:47.789Z"
        },
        "createdAt": "2025-07-05T16:03:47.789Z",
        "updatedAt": "2025-07-05T16:03:47.789Z"
      },
      "requests": [
        {
          "id": 1,
          "bookId": 1,
          "book": {
            "id": 1,
            "name": "text",
            "addresses": "[Circular Reference]",
            "walletIds": "[Circular Reference]",
            "ownerId": "text",
            "owner": {
              "owner": "text",
              "ownerId": "text",
              "ownerIdentity": {
                "id": "text",
                "identifier": "text",
                "providerId": "text",
                "provider": {
                  "id": "text",
                  "logo": "text",
                  "apiKey": "text",
                  "delimiter": "text",
                  "txHash": "text",
                  "registry": "[Circular Reference]",
                  "dataSourceId": 1,
                  "ownerId": "text",
                  "updatedAt": "2025-07-05T16:03:47.789Z",
                  "createdAt": "2025-07-05T16:03:47.789Z"
                },
                "defaultAddress": "text",
                "default": {
                  "address": "text",
                  "chain": {
                    "id": 1,
                    "name": "text",
                    "symbol": "text",
                    "icon": "text",
                    "rpc": [
                      "text"
                    ],
                    "type": "EVM",
                    "shortName": "text",
                    "infoURL": "text",
                    "chainId": 1,
                    "updatedAt": "2025-07-05T16:03:47.789Z",
                    "createdAt": "2025-07-05T16:03:47.789Z"
                  },
                  "chainId": 1,
                  "isMultisig": false,
                  "isSmartContractWallet": false,
                  "walletId": {
                    "id": 1,
                    "name": "text",
                    "symbol": "text",
                    "icon": "text",
                    "rpc": [
                      "text"
                    ],
                    "type": "EVM",
                    "shortName": "text",
                    "infoURL": "text",
                    "chainId": 1,
                    "updatedAt": "2025-07-05T16:03:47.789Z",
                    "createdAt": "2025-07-05T16:03:47.789Z"
                  },
                  "updatedAt": "2025-07-05T16:03:47.789Z",
                  "createdAt": "2025-07-05T16:03:47.789Z"
                },
                "secondary": [
                  "[Circular Reference]"
                ],
                "nonce": 0,
                "currentSignature": "text",
                "previousSignature": "text",
                "isContract": false,
                "syncedAt": "2025-07-05T16:03:47.789Z",
                "createdAt": "2025-07-05T16:03:47.789Z"
              },
              "createdAt": "2025-07-05T16:03:47.789Z",
              "updatedAt": "2025-07-05T16:03:47.789Z"
            },
            "requests": "[Circular Reference]",
            "createdAt": "2025-07-05T16:03:47.789Z",
            "updatedAt": "2025-07-05T16:03:47.789Z"
          },
          "toId": "text",
          "to": {
            "owner": "text",
            "ownerId": "text",
            "ownerIdentity": {
              "id": "text",
              "identifier": "text",
              "providerId": "text",
              "provider": {
                "id": "text",
                "logo": "text",
                "apiKey": "text",
                "delimiter": "text",
                "txHash": "text",
                "registry": "[Circular Reference]",
                "dataSourceId": 1,
                "ownerId": "text",
                "updatedAt": "2025-07-05T16:03:47.789Z",
                "createdAt": "2025-07-05T16:03:47.789Z"
              },
              "defaultAddress": "text",
              "default": {
                "address": "text",
                "chain": {
                  "id": 1,
                  "name": "text",
                  "symbol": "text",
                  "icon": "text",
                  "rpc": [
                    "text"
                  ],
                  "type": "EVM",
                  "shortName": "text",
                  "infoURL": "text",
                  "chainId": 1,
                  "updatedAt": "2025-07-05T16:03:47.789Z",
                  "createdAt": "2025-07-05T16:03:47.789Z"
                },
                "chainId": 1,
                "isMultisig": false,
                "isSmartContractWallet": false,
                "walletId": {
                  "id": 1,
                  "name": "text",
                  "symbol": "text",
                  "icon": "text",
                  "rpc": [
                    "text"
                  ],
                  "type": "EVM",
                  "shortName": "text",
                  "infoURL": "text",
                  "chainId": 1,
                  "updatedAt": "2025-07-05T16:03:47.789Z",
                  "createdAt": "2025-07-05T16:03:47.789Z"
                },
                "updatedAt": "2025-07-05T16:03:47.789Z",
                "createdAt": "2025-07-05T16:03:47.789Z"
              },
              "secondary": [
                "[Circular Reference]"
              ],
              "nonce": 0,
              "currentSignature": "text",
              "previousSignature": "text",
              "isContract": false,
              "syncedAt": "2025-07-05T16:03:47.789Z",
              "createdAt": "2025-07-05T16:03:47.789Z"
            },
            "createdAt": "2025-07-05T16:03:47.789Z",
            "updatedAt": "2025-07-05T16:03:47.789Z"
          },
          "access": "READ",
          "pending": true,
          "accepted": false,
          "createdAt": "2025-07-05T16:03:47.789Z",
          "updatedAt": "2025-07-05T16:03:47.789Z"
        }
      ],
      "createdAt": "2025-07-05T16:03:47.789Z",
      "updatedAt": "2025-07-05T16:03:47.789Z"
    }
  ],
  "status": 1,
  "timestamp": "2025-07-05T16:03:47.789Z"
}
PreviousAddress BooksNextHow to create address books?

Last updated