Delegates

get

Returns a list with all the delegates

Authorizations

cookieAuthtokenAuth

sessionidstringOptional

Query parameters

safestring · nullableOptional

delegatestringOptional

delegatorstringOptional

labelstringOptional

limitintegerOptional

Number of results to return per page.

offsetintegerOptional

The initial index from which to return the results.

Responses

200Success

application/json

countintegerRequiredExample: 123

nextstring · uri · nullableOptionalExample: http://api.example.org/accounts/?offset=400&limit=100

previousstring · uri · nullableOptionalExample: http://api.example.org/accounts/?offset=200&limit=100

400

Invalid data

get

/api/v2/delegates/

HTTPcURLJavaScriptPython

GET /api/v2/delegates/ HTTP/1.1
Accept: */*

{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "safe": "text",
      "delegate": "text",
      "delegator": "text",
      "label": "text",
      "expiryDate": "2026-02-20T19:12:51.748Z"
    }
  ]
}

post

Adds a new Safe delegate with a custom label. Calls with same delegate but different label or signer will update the label or delegator if a different one is provided. To generate the signature, the following EIP712 data hash needs to be signed:

 {
    "types": {
        "EIP712Domain": [
            {"name": "name", "type": "string"},
            {"name": "version", "type": "string"},
            {"name": "chainId", "type": "uint256"},
        ],
        "Delegate": [
            {"name": "delegateAddress", "type": "address"},
            {"name": "totp", "type": "uint256"},
        ],
    },
    "primaryType": "Delegate",
    "domain": {
        "name": "Safe Transaction Service",
        "version": "1.0",
        "chainId": chain_id,
    },
    "message": {
        "delegateAddress": delegate_address,
        "totp": totp,
    },
}

For the signature we use TOTP with T0=0 and Tx=3600. TOTP is calculated by taking the Unix UTC epoch time (no milliseconds) and dividing by 3600 (natural division, no decimals).

Authorizations

cookieAuthtokenAuth

sessionidstringOptional

Body

application/json

Mixin to validate delegate operations data

safestring · nullableOptional

delegatestringRequired

delegatorstringRequired

signaturestringRequired

labelstring · max: 50Required

expiryDatestring · nullableOptional

Responses

202

Accepted

400

Malformed data

post

/api/v2/delegates/

HTTPcURLJavaScriptPython

POST /api/v2/delegates/ HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 102

{
  "safe": null,
  "delegate": "text",
  "delegator": "text",
  "signature": "text",
  "label": "text",
  "expiryDate": null
}

No content

delete

Removes every delegate/delegator pair found associated with a given delegate address. The signature is built the same way as for adding a delegate, but in this case the signer can be either the delegator (owner) or the delegate itself. Check POST /delegates/ to learn more.

Authorizations

cookieAuthtokenAuth

sessionidstringOptional

Path parameters

delegate_addressstringRequired

Responses

204

Deleted

400

Malformed data

404

Delegate not found

422

Invalid Ethereum address/Error processing data

delete

/api/v2/delegates/{delegate_address}/

HTTPcURLJavaScriptPython

DELETE /api/v2/delegates/{delegate_address}/ HTTP/1.1
Accept: */*

No content