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

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

Call API

PreviousHow to share address book?NextUtility

Last updated 1 year ago

Generate message for sharing address book

post

/address-books/request/message

Authorizations

Body

idinteger

bookintegerrequired

tostring

pendingboolean · default: true

acceptedboolean

createdAtstring · date-time

updatedAtstring · date-timerequired

accessstring · enumrequired

Options: READ, READWRITE

Responses

application/json

cURL

JavaScript

Python

HTTP

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 '{"book":1,"pending":true,"accepted":false,"updatedAt":"2025-02-23T10:33:45.506Z","access":"READ"}'

200

400

401

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

Successful response

Update address book request

patch

/address-books/request