How to accept address book request?

Accepting request to address book

Arrange Data

Arrange data in the format

{
    "id": number, // request id
}

Generate & Sign Message

Call this API to get the message

Generate message for sharing address book

post

Authorizations

Body

idintegeroptional

bookintegerrequired

tostringoptional

accessstring · enumrequired

Available options:

pendingboolean · default: trueoptional

acceptedboolean · default: falseoptional

createdAtstring · date-timeoptional

updatedAtstring · date-timerequired

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://sandbox-api.fetcch.xyz/v1/address-books/request/message' \
  --header 'secret-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": 1,
    "book": 1,
    "to": "text",
    "access": "READ",
    "pending": true,
    "accepted": true,
    "createdAt": "2025-04-03T04:51:22.417Z",
    "updatedAt": "2025-04-03T04:51:22.417Z"
  }'

200

400

401

200

{
  "data": {
    "message": "text",
    "request": {
      "id": 1,
      "bookId": 1,
      "book": {
        "id": 1,
        "name": "text",
        "addresses": [
          {
            "id": 1,
            "address": "text",
            "chainType": "EVM",
            "name": "text",
            "addressBookId": 1,
            "addressBook": "[Circular Reference]"
          }
        ],
        "walletIds": [
          {
            "id": 1,
            "walletId": "text",
            "wallet": "[Circular Reference]",
            "name": "text",
            "addressBookId": 1,
            "addressBook": "[Circular Reference]",
            "createdAt": "2025-04-03T04:51:22.417Z",
            "updatedAt": "2025-04-03T04:51:22.417Z"
          }
        ],
        "ownerId": "text",
        "owner": {
          "owner": "text",
          "ownerId": "text",
          "ownerIdentity": {
            "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-04-03T04:51:22.417Z",
                "createdAt": "2025-04-03T04:51:22.417Z"
              },
              "chainId": 1,
              "isMultisig": true,
              "isSmartContractWallet": true,
              "walletId": {
                "id": 1,
                "name": "text",
                "symbol": "text",
                "icon": "text",
                "rpc": [
                  "text"
                ],
                "type": "EVM",
                "shortName": "text",
                "infoURL": "text",
                "chainId": 1,
                "updatedAt": "2025-04-03T04:51:22.417Z",
                "createdAt": "2025-04-03T04:51:22.417Z"
              },
              "updatedAt": "2025-04-03T04:51:22.417Z",
              "createdAt": "2025-04-03T04:51:22.417Z"
            },
            "secondary": "[Circular Reference]",
            "nonce": 1,
            "currentSignature": "text",
            "previousSignature": "text",
            "isContract": true,
            "syncedAt": "2025-04-03T04:51:22.417Z",
            "createdAt": "2025-04-03T04:51:22.417Z"
          },
          "createdAt": "2025-04-03T04:51:22.417Z",
          "updatedAt": "2025-04-03T04:51:22.417Z"
        },
        "requests": [
          {
            "id": 1,
            "bookId": 1,
            "book": "[Circular Reference]",
            "toId": "text",
            "to": "[Circular Reference]",
            "access": "READ",
            "pending": true,
            "accepted": true,
            "createdAt": "2025-04-03T04:51:22.417Z",
            "updatedAt": "2025-04-03T04:51:22.417Z"
          }
        ],
        "createdAt": "2025-04-03T04:51:22.417Z",
        "updatedAt": "2025-04-03T04:51:22.417Z"
      },
      "toId": "text",
      "to": {
        "owner": "text",
        "ownerId": "text",
        "ownerIdentity": {
          "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-04-03T04:51:22.417Z",
              "createdAt": "2025-04-03T04:51:22.417Z"
            },
            "chainId": 1,
            "isMultisig": true,
            "isSmartContractWallet": true,
            "walletId": {
              "id": 1,
              "name": "text",
              "symbol": "text",
              "icon": "text",
              "rpc": [
                "text"
              ],
              "type": "EVM",
              "shortName": "text",
              "infoURL": "text",
              "chainId": 1,
              "updatedAt": "2025-04-03T04:51:22.417Z",
              "createdAt": "2025-04-03T04:51:22.417Z"
            },
            "updatedAt": "2025-04-03T04:51:22.417Z",
            "createdAt": "2025-04-03T04:51:22.417Z"
          },
          "secondary": "[Circular Reference]",
          "nonce": 1,
          "currentSignature": "text",
          "previousSignature": "text",
          "isContract": true,
          "syncedAt": "2025-04-03T04:51:22.417Z",
          "createdAt": "2025-04-03T04:51:22.417Z"
        },
        "createdAt": "2025-04-03T04:51:22.417Z",
        "updatedAt": "2025-04-03T04:51:22.417Z"
      },
      "access": "READ",
      "pending": true,
      "accepted": true,
      "createdAt": "2025-04-03T04:51:22.417Z",
      "updatedAt": "2025-04-03T04:51:22.417Z"
    }
  },
  "status": 1,
  "timestamp": "2025-04-03T04:51:22.417Z"
}

Successful response

Sign the above message by following signature guidelines mentioned here according to the chain you are using

Call API

Update address book request

patch

Authorizations

Body

signaturestringoptional

idintegeroptional

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url 'https://sandbox-api.fetcch.xyz/v1/address-books/request' \
  --header 'secret-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "signature": "text",
    "id": 1
  }'

200

400

401

200

{
  "data": {
    "message": "text",
    "request": {
      "id": 1,
      "bookId": 1,
      "book": {
        "id": 1,
        "name": "text",
        "addresses": [
          {
            "id": 1,
            "address": "text",
            "chainType": "EVM",
            "name": "text",
            "addressBookId": 1,
            "addressBook": "[Circular Reference]"
          }
        ],
        "walletIds": [
          {
            "id": 1,
            "walletId": "text",
            "wallet": "[Circular Reference]",
            "name": "text",
            "addressBookId": 1,
            "addressBook": "[Circular Reference]",
            "createdAt": "2025-04-03T04:51:22.417Z",
            "updatedAt": "2025-04-03T04:51:22.417Z"
          }
        ],
        "ownerId": "text",
        "owner": {
          "owner": "text",
          "ownerId": "text",
          "ownerIdentity": {
            "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-04-03T04:51:22.417Z",
                "createdAt": "2025-04-03T04:51:22.417Z"
              },
              "chainId": 1,
              "isMultisig": true,
              "isSmartContractWallet": true,
              "walletId": {
                "id": 1,
                "name": "text",
                "symbol": "text",
                "icon": "text",
                "rpc": [
                  "text"
                ],
                "type": "EVM",
                "shortName": "text",
                "infoURL": "text",
                "chainId": 1,
                "updatedAt": "2025-04-03T04:51:22.417Z",
                "createdAt": "2025-04-03T04:51:22.417Z"
              },
              "updatedAt": "2025-04-03T04:51:22.417Z",
              "createdAt": "2025-04-03T04:51:22.417Z"
            },
            "secondary": "[Circular Reference]",
            "nonce": 1,
            "currentSignature": "text",
            "previousSignature": "text",
            "isContract": true,
            "syncedAt": "2025-04-03T04:51:22.417Z",
            "createdAt": "2025-04-03T04:51:22.417Z"
          },
          "createdAt": "2025-04-03T04:51:22.417Z",
          "updatedAt": "2025-04-03T04:51:22.417Z"
        },
        "requests": [
          {
            "id": 1,
            "bookId": 1,
            "book": "[Circular Reference]",
            "toId": "text",
            "to": "[Circular Reference]",
            "access": "READ",
            "pending": true,
            "accepted": true,
            "createdAt": "2025-04-03T04:51:22.417Z",
            "updatedAt": "2025-04-03T04:51:22.417Z"
          }
        ],
        "createdAt": "2025-04-03T04:51:22.417Z",
        "updatedAt": "2025-04-03T04:51:22.417Z"
      },
      "toId": "text",
      "to": {
        "owner": "text",
        "ownerId": "text",
        "ownerIdentity": {
          "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-04-03T04:51:22.417Z",
              "createdAt": "2025-04-03T04:51:22.417Z"
            },
            "chainId": 1,
            "isMultisig": true,
            "isSmartContractWallet": true,
            "walletId": {
              "id": 1,
              "name": "text",
              "symbol": "text",
              "icon": "text",
              "rpc": [
                "text"
              ],
              "type": "EVM",
              "shortName": "text",
              "infoURL": "text",
              "chainId": 1,
              "updatedAt": "2025-04-03T04:51:22.417Z",
              "createdAt": "2025-04-03T04:51:22.417Z"
            },
            "updatedAt": "2025-04-03T04:51:22.417Z",
            "createdAt": "2025-04-03T04:51:22.417Z"
          },
          "secondary": "[Circular Reference]",
          "nonce": 1,
          "currentSignature": "text",
          "previousSignature": "text",
          "isContract": true,
          "syncedAt": "2025-04-03T04:51:22.417Z",
          "createdAt": "2025-04-03T04:51:22.417Z"
        },
        "createdAt": "2025-04-03T04:51:22.417Z",
        "updatedAt": "2025-04-03T04:51:22.417Z"
      },
      "access": "READ",
      "pending": true,
      "accepted": true,
      "createdAt": "2025-04-03T04:51:22.417Z",
      "updatedAt": "2025-04-03T04:51:22.417Z"
    }
  },
  "status": 1,
  "timestamp": "2025-04-03T04:51:22.417Z"
}

Successful response