> ## Documentation Index > Fetch the complete documentation index at: https://docs.dfns.co/llms.txt > Use this file to discover all available pages before exploring further. # Get Signature > Retrieve a signature request details. ## OpenAPI ````yaml /openapi.yaml get /keys/{keyId}/signatures/{signatureId} openapi: 3.1.0 info: version: 1.807.0 title: Dfns servers: - url: https://api.dfns.io description: Default - Europe - url: https://api.uae.dfns.io description: UAE - url: https://api.dfns.ninja description: Staging security: [] paths: /keys/{keyId}/signatures/{signatureId}: get: tags: - Keys summary: Get Signature description: Retrieve a signature request details. parameters: - schema: type: string minLength: 1 maxLength: 64 description: The key that was used for signing. required: true description: The key that was used for signing. name: keyId in: path - schema: type: string minLength: 1 maxLength: 64 description: The signature request to retrieve. required: true description: The signature request to retrieve. name: signatureId in: path responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/SignatureRequest' security: - authenticationToken: [] components: schemas: SignatureRequest: type: object properties: id: type: string minLength: 1 maxLength: 64 pattern: ^sig-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$ description: Signature id. example: sig-4sfvl-f4iha-umighfi3hk4t54dr keyId: type: string minLength: 1 maxLength: 64 pattern: ^key-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$ description: Key id. example: key-01snl-t56gb-j8tsok0vn802p80i requester: $ref: '#/components/schemas/Requester' requestBody: oneOf: - type: object properties: kind: type: string enum: - Hash hash: type: string pattern: ^(0x)?[0-9a-fA-F]{64}$ description: 32-byte hash in hex encoded format. taprootMerkleRoot: type: string pattern: ^(0x)?([0-9A-Fa-f]{64})?$ description: >- Required when signing with a Schnorr key. Specify the merkle root for tweaking the signing key, or the empty string "" to tweak with the default merkle root. network: $ref: '#/components/schemas/Network' blockchainKind: $ref: '#/components/schemas/BlockchainKind' externalId: type: string minLength: 1 maxLength: 50 description: >- A unique ID from your system. It can be leveraged to be used as an idempotency key (read more [here](https://docs.dfns.co/api-reference/idempotency)). required: - kind - hash additionalProperties: false description: >- All cryptographic scheme support hash signing. Different blockchains will apply different hash functions to compute the hash. title: Hash - type: object properties: kind: type: string enum: - Message message: type: string pattern: ^(0x)?([0-9a-fA-F][0-9a-fA-F])*$ description: An arbitrary hex encoded message. network: $ref: '#/components/schemas/Network' blockchainKind: $ref: '#/components/schemas/BlockchainKind' externalId: type: string minLength: 1 maxLength: 50 description: >- A unique ID from your system. It can be leveraged to be used as an idempotency key (read more [here](https://docs.dfns.co/api-reference/idempotency)). required: - kind - message additionalProperties: false description: Signs an arbitrary hex encoded arbitrary message. title: Message - type: object properties: kind: type: string enum: - Transaction transaction: anyOf: - type: string pattern: ^(0x)?([0-9a-fA-F][0-9a-fA-F])*$ - type: object properties: {} description: >- The unsigned hex encoded transaction or JSON object for compatible networks network: $ref: '#/components/schemas/Network' blockchainKind: $ref: '#/components/schemas/BlockchainKind' externalId: type: string minLength: 1 maxLength: 50 description: >- A unique ID from your system. It can be leveraged to be used as an idempotency key (read more [here](https://docs.dfns.co/api-reference/idempotency)). required: - kind - transaction additionalProperties: false description: >- Signs an unsigned transaction. The transaction parameter accepts hex-encoded transactions or JSON objects for compatible networks (Concordium, Starknet, Evm). The following blockchains only accept JSON transaction objects (not hex strings): Concordium, Starknet. For Starknet transactions, you may use invocation request objects (https://github.com/starkware-libs/starknet-specs/blob/v0.8.1/api/starknet_api_openrpc.json#L2621): | Field | Description | Type - Optional | |-------------------------------|-----------------------------------------------------------------------------------------------------|----------------------------------| | type | transaction type (always INVOKE ) | String (required) | | calldata | **Array** of encoded function call parameters | **Array of Strings** (required) | | nonce | Transaction nonce in hex format | String (required) | | version | Transaction version in hex format. Typically "0x3" for current transactions | String (required) | | resourceBounds | Gas bounds for L1, L2, and L1 data gas | Object (required) | | ↳ resourceBounds.l1Gas | L1 gas configuration with maxAmount and maxPricePerUnit | Object (required) | | ↳ resourceBounds.l2Gas | L2 gas configuration with maxAmount and maxPricePerUnit | Object (required) | | ↳ resourceBounds.l1DataGas | L1 data gas configuration with maxAmount and maxPricePerUnit | Object (required) | | tip | Transaction tip in hex format. Typically "0x0" | String (required) | | paymasterData | Paymaster data array | Array of Strings (required) | | accountDeploymentData | Account deployment data array | Array of Strings (required) | | nonceDataAvailabilityMode | Data availability mode for nonce. Typically "L1" for now | String (required) | | feeDataAvailabilityMode | Data availability mode for fee. Typically "L1" for now | String (required) | | chainId | The chain identifier in hex format | String (required) | | senderAddress | The address of the account sending the transaction | String (required) | For Concordium transactions, use account transaction objects (https://developer.concordium.software/concordium-node-sdk-js/classes/ccd_js_gen.ConcordiumGRPCClient.html): | Field | Description | Type - Optional | |--------------------------------|------------------------------------------------------------------------------|------------------------------| | header.sender | Account address (base58) | String (required) | | header.nonce | Account nonce | String (required) | | header.expiry | Unix epoch seconds expiry | Number (required) | | header.executionEnergyAmount | Max NRG for execution | String (required) | | header.numSignatures | Number of signatures | Number (optional) | | payload | Transaction payload (type-specific, e.g. Transfer, RegisterData) | Object (required) | ```json { "kind": "Transaction", "blockchainKind": "Concordium", "transaction": { "header": { "sender": "4FmiTW2L2AccyR36ZBRKNqwQvBJBH8CAXWMLB1dbX5WyZmRo6N", "nonce": "42", "expiry": 1709510400, "executionEnergyAmount": "501" }, "payload": { "Transfer": { "amount": "1000000", "toAddress": "3U4sfVSqGG6XK8g6eho2qRYtnHc4MWJBG1dfxdtPGbfHwFxini" } } } } ``` ```json { "kind": "Transaction", "transaction": "0xe703847735941a82520894f0965f5eb35ace69f01b77031f2cff22daca622887470de4df82000080" } ``` ```json { "kind": "Transaction", "transaction": { "type": "INVOKE", "calldata": [ "1", "2009894490435840142178314390393166646092438090257831307886760648929397478285", "232670485425082704932579856502088130646006032362877466777181098476241604910", "3", "296727860213112272332383824629975240127004024814636931420022890499591637514", "1", "0" ], "nonce": "0x51", "version": "0x3", "resourceBounds": { "l1Gas": { "maxAmount": "0x0", "maxPricePerUnit": "0x239a01ff6e6c" }, "l2Gas": { "maxAmount": "0x1694a0", "maxPricePerUnit": "0x10c388d00" }, "l1DataGas": { "maxAmount": "0x120", "maxPricePerUnit": "0x98e8" } }, "tip": "0x0", "paymasterData": [], "accountDeploymentData": [], "nonceDataAvailabilityMode": "L1", "feeDataAvailabilityMode": "L1", "chainId": "0x534e5f5345504f4c4941", "senderAddress": "0x0535a9762b984c876abe0b164b0ccedb0d23a78978c9fe87e29deae0ea890c72" } } ``` title: Transaction - type: object properties: kind: type: string enum: - Eip191 message: type: string pattern: ^(0x)?([0-9a-fA-F][0-9a-fA-F])*$ description: Hex-encoded message. network: $ref: '#/components/schemas/Network' blockchainKind: $ref: '#/components/schemas/BlockchainKind' externalId: type: string minLength: 1 maxLength: 50 description: >- A unique ID from your system. It can be leveraged to be used as an idempotency key (read more [here](https://docs.dfns.co/api-reference/idempotency)). required: - kind - message additionalProperties: false description: >- Signs an personal_sign message as defined in [EIP-191](https://eips.ethereum.org/EIPS/eip-191). title: EIP-191 personal_sign Message - type: object properties: kind: type: string enum: - Eip712 types: type: object additionalProperties: type: array items: type: object properties: name: type: string type: type: string required: - name - type additionalProperties: false description: Type definitions. domain: type: object properties: name: type: string description: Name of the signing domain. version: type: string description: Current major version of the signing domain. chainId: anyOf: - type: integer exclusiveMinimum: 0 - type: string description: Chain ID. verifyingContract: type: string pattern: ^0x[0-9a-fA-F]{40}$ description: >- The address of the contract that will verify the signature. salt: type: string pattern: ^0x[0-9a-fA-F]{64}$ description: 32-byte value as a last-resort domain separator. additionalProperties: false description: Domain separator. message: type: object additionalProperties: {} description: Structured message to sign. network: $ref: '#/components/schemas/Network' blockchainKind: $ref: '#/components/schemas/BlockchainKind' externalId: type: string minLength: 1 maxLength: 50 description: >- A unique ID from your system. It can be leveraged to be used as an idempotency key (read more [here](https://docs.dfns.co/api-reference/idempotency)). required: - kind - types - domain - message additionalProperties: false description: >- Signs a typed structured data as defined in [EIP-712](https://eips.ethereum.org/EIPS/eip-712). title: EIP-712 TypedData - type: object properties: kind: type: string enum: - Eip7702 address: type: string pattern: ^(0x)?([0-9a-fA-F][0-9a-fA-F])*$ description: >- The address of the contract the signer's EOA will be delegated to. nonce: type: number description: The current nonce of the signer EOA. chainId: type: number description: Chain ID. network: $ref: '#/components/schemas/Network' blockchainKind: $ref: '#/components/schemas/BlockchainKind' externalId: type: string minLength: 1 maxLength: 50 description: >- A unique ID from your system. It can be leveraged to be used as an idempotency key (read more [here](https://docs.dfns.co/api-reference/idempotency)). required: - kind - address - nonce - chainId additionalProperties: false description: >- Signs an authorization tuple for type 4 set code transaction defined in [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702). title: EIP-7702 Authorization - type: object properties: kind: type: string enum: - Snip12 primaryType: type: string description: The primary type of the message. types: type: object additionalProperties: type: array items: type: object properties: name: type: string type: type: string required: - name - type additionalProperties: false description: Type definitions. domain: type: object properties: name: type: string description: Name of the signing domain. version: type: string description: Current major version of the signing domain. chainId: anyOf: - type: integer exclusiveMinimum: 0 - type: string description: Chain ID. revision: anyOf: - type: number - type: string description: Revision of the domain. description: Domain separator. message: type: object additionalProperties: {} description: Structured message to sign. network: $ref: '#/components/schemas/Network' blockchainKind: $ref: '#/components/schemas/BlockchainKind' externalId: type: string minLength: 1 maxLength: 50 description: >- A unique ID from your system. It can be leveraged to be used as an idempotency key (read more [here](https://docs.dfns.co/api-reference/idempotency)). required: - kind - primaryType - types - domain - message additionalProperties: false description: >- Signs a typed structured data as defined in [SNIP-12](https://github.com/starknet-io/SNIPs/blob/main/SNIPS/snip-12.md). title: SNIP-12 TypedData - type: object properties: kind: type: string enum: - Psbt psbt: type: string pattern: ^(0x)?([0-9a-fA-F][0-9a-fA-F])*$ description: The hex encoded PSBT. network: $ref: '#/components/schemas/Network' blockchainKind: $ref: '#/components/schemas/BlockchainKind' externalId: type: string minLength: 1 maxLength: 50 description: >- A unique ID from your system. It can be leveraged to be used as an idempotency key (read more [here](https://docs.dfns.co/api-reference/idempotency)). required: - kind - psbt additionalProperties: false description: Signs a partially signed Bitcoin / Litecoin transaction. title: PSBT - type: object properties: kind: type: string enum: - Bip322 message: type: string pattern: ^(0x)?([0-9a-fA-F][0-9a-fA-F])*$ description: The generic message hex encoded. format: type: string enum: - Simple - Full description: >- Defaults to Simple if not present. The formatted signature is returned in the `signedData` field in the response. network: $ref: '#/components/schemas/Network' blockchainKind: $ref: '#/components/schemas/BlockchainKind' externalId: type: string minLength: 1 maxLength: 50 description: >- A unique ID from your system. It can be leveraged to be used as an idempotency key (read more [here](https://docs.dfns.co/api-reference/idempotency)). required: - kind - message additionalProperties: false description: >- Signs a generic message using [BIP-322](https://github.com/bitcoin/bips/blob/master/bip-0322.mediawiki). Note: signing payload construction depends on the targeted blockchain. Therefore it's tied to a specific `network` rather than the blockchain kind. title: BIP-322 - type: object properties: kind: type: string enum: - SignDocDirect signDoc: type: string pattern: ^(0x)?([0-9a-fA-F][0-9a-fA-F])*$ description: The hex encoded `SignDoc` Protobuf. network: $ref: '#/components/schemas/Network' blockchainKind: $ref: '#/components/schemas/BlockchainKind' externalId: type: string minLength: 1 maxLength: 50 description: >- A unique ID from your system. It can be leveraged to be used as an idempotency key (read more [here](https://docs.dfns.co/api-reference/idempotency)). required: - kind - signDoc additionalProperties: false description: >- Signs an unsigned transaction using [sign mode direct](https://docs.cosmos.network/main/learn/advanced/transactions#sign_mode_direct-preferred). title: SignDocDirect - type: object properties: kind: type: string enum: - SignerPayload payload: anyOf: - type: string pattern: ^(0x)?([0-9a-fA-F][0-9a-fA-F])*$ - type: object properties: {} description: > The unsigned Signer Payload formatted as JSON, or as a serialized hex-encoded buffer. Please refer to the original Polkadot definition for more details: [SignerPayloadJson](https://github.com/polkadot-js/api/blob/v16.2.2/packages/types/src/types/extrinsic.ts#L32). Note that additional fields will be rejected. | Field | Description | Type - Optional | | -------------------- | ---------------------------------------------------------------------------------------- | -------------------- | | `address` | ss58-encoded address of the sending account. | String | | `blockHash` | The hash of the checkpoint block, hex encoded. | String | | `blockNumber` | The checkpoint block number, hex encoded. | String | | `era` | The number of blocks after the checkpoint for which a transaction is valid, hex encoded. | String | | `genesisHash` | The genesis hash of the chain, hex encoded. | String | | `metadataHash` | The metadataHash for the CheckMetadataHash SignedExtension, hex encoded. | String *(optional)* | | `mode` | flag indicating whether to verify the metadata hash or not. | Integer *(optional)* | | `method` | The encoded method with arguments, hex encoded. | String | | `nonce` | The nonce for the transaction, hex encoded. | String | | `tip` | The tip to increase transaction priority, hex encoded. | String | | `version` | The version of the extrinsic. | Integer | | `specVersion` | The current spec version for the runtime, hex encoded. | String | | `transactionVersion` | The current transaction version for the runtime, hex encoded. | String | | `signedExtensions` | The applicable signed extensions for this runtime. | Array | ```json { "network": "Polymesh", "kind": "SignerPayload", "payload": { "address": "5H5tTnmLUqRgvTZvTwCdBKYjKLBm2gkp7u38Q9UUdJa8m6rX", "blockHash": "0x2ace05e703aa50b48c0ccccfc8b424f7aab9a1e2c424ed12e45d20b1e8ffd0d6", "blockNumber": "0x00000000", "era": "0x00", "genesisHash": "0x2ace05e703aa50b48c0ccccfc8b424f7aab9a1e2c424ed12e45d20b1e8ffd0d6", "method": "0x07141f3da32e72ac6eb6cb40d9e757594363a617b2c3964a2b6ec6895c6648f48d500000", "nonce": "0x00000000", "tip": "0x00000000000000000000000000000000", "version": 4, "specVersion": "0x006adb7a", "transactionVersion": "0x00000007", "signedExtensions": [] } } ``` network: $ref: '#/components/schemas/Network' blockchainKind: $ref: '#/components/schemas/BlockchainKind' externalId: type: string minLength: 1 maxLength: 50 description: >- A unique ID from your system. It can be leveraged to be used as an idempotency key (read more [here](https://docs.dfns.co/api-reference/idempotency)). required: - kind - payload additionalProperties: false description: >- Signs a [generic Signer Payload](https://github.com/polkadot-js/api/blob/v15.0.1/packages/types/src/extrinsic/SignerPayload.ts#L47-L51). Note: converting the generic signer payload to a signable extrinsic requires fetching metadata from the targeted blockchain. Therefore it's tied to a specific `network` rather than the blockchain kind. title: SignerPayload - type: object properties: kind: type: string enum: - Cip8 payload: type: string pattern: ^(0x)?([0-9a-fA-F][0-9a-fA-F])*$ description: The generic message hex encoded. externalAad: type: string pattern: ^(0x)?([0-9a-fA-F][0-9a-fA-F])*$ description: >- Allows an application to ask the user to sign some extra data but NOT put it inside the COSE structure (only as part of the data to sign). context: type: string enum: - Signature1 network: $ref: '#/components/schemas/Network' blockchainKind: $ref: '#/components/schemas/BlockchainKind' externalId: type: string minLength: 1 maxLength: 50 description: >- A unique ID from your system. It can be leveraged to be used as an idempotency key (read more [here](https://docs.dfns.co/api-reference/idempotency)). required: - kind - context additionalProperties: false description: >- Signs an arbitrary message using [CIP-8](https://cips.cardano.org/cip/CIP-0008). Note: signing address depends on the targeted blockchain. Therefore it's tied to a specific `network` rather than the blockchain kind. title: CIP-8 - type: object properties: kind: type: string enum: - DfnsSmartAccountTransaction structured: type: object properties: address: type: string userOperations: type: array items: type: object properties: to: type: string value: type: string data: type: string required: - to message: type: object properties: kind: type: string enum: - Eip712 domain: type: object properties: name: type: string version: type: string chainId: anyOf: - type: number - type: string verifyingContract: type: string salt: type: string types: type: object additionalProperties: type: array items: type: object properties: name: type: string type: type: string required: - name - type message: type: object additionalProperties: {} required: - kind - domain - types - message authorization: type: object properties: kind: type: string enum: - Eip7702 address: type: string nonce: type: number chainId: type: number required: - kind - address - nonce - chainId required: - address - userOperations - message signatures: type: object additionalProperties: type: object properties: r: type: string s: type: string recid: type: number encoded: type: string required: - r - s transactionReference: type: string network: $ref: '#/components/schemas/Network' blockchainKind: $ref: '#/components/schemas/BlockchainKind' externalId: type: string minLength: 1 maxLength: 50 description: >- A unique ID from your system. It can be leveraged to be used as an idempotency key (read more [here](https://docs.dfns.co/api-reference/idempotency)). required: - kind - structured - signatures - transactionReference additionalProperties: false title: Dfns Smart Account Transaction - type: object properties: kind: type: string enum: - StellarFeeBumpTransaction innerTransaction: type: string transactionReference: type: string network: $ref: '#/components/schemas/Network' blockchainKind: $ref: '#/components/schemas/BlockchainKind' externalId: type: string minLength: 1 maxLength: 50 description: >- A unique ID from your system. It can be leveraged to be used as an idempotency key (read more [here](https://docs.dfns.co/api-reference/idempotency)). required: - kind - innerTransaction - transactionReference additionalProperties: false title: Stellar Fee Bump Transaction status: type: string enum: - Pending - Executing - Signed - Confirmed - Failed - Rejected reason: type: string signature: type: object properties: r: type: string s: type: string recid: type: number encoded: type: string required: - r - s signatures: type: array items: type: object properties: r: type: string s: type: string recid: type: number encoded: type: string required: - r - s signedData: type: string network: $ref: '#/components/schemas/Network' txHash: type: string fee: type: string approvalId: type: string minLength: 1 maxLength: 64 pattern: ^ap-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$ example: ap-2a9in-tt2a1-983lho480p35ejd0 dateRequested: type: string format: date-time description: >- [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date (must be UTC). When the signature was requested. example: '2023-04-14T20:41:28.715Z' datePolicyResolved: type: string format: date-time description: >- [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date (must be UTC). When the signature was approved by policy reviewers. example: '2023-04-14T20:41:28.715Z' dateSigned: type: string format: date-time description: >- [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date (must be UTC). When the signature was signed. example: '2023-04-14T20:41:28.715Z' dateConfirmed: type: string format: date-time description: >- [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date (must be UTC). When the signature was confirmed on chain. example: '2023-04-14T20:41:28.715Z' externalId: type: string required: - id - keyId - requester - requestBody - status - dateRequested Requester: type: object properties: userId: type: string minLength: 1 maxLength: 64 pattern: ^us-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$ description: User id. example: us-6b58p-r53sr-rlrd3l5cj3uc4ome tokenId: type: string minLength: 1 maxLength: 64 pattern: ^to-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$ description: Token id. example: to-202a0-cdo33-o65mbt6q758lvvnt required: - userId description: The user who initiated the request. Network: type: string title: Network enum: - Algorand - AlgorandTestnet - Aptos - AptosTestnet - ArbitrumOne - ArbitrumSepolia - ArcTestnet - AvalancheC - AvalancheCFuji - BabylonGenesis - BabylonTestnet5 - Base - BaseSepolia - Berachain - BerachainBepolia - Bitcoin - BitcoinSignet - BitcoinTestnet3 - BitcoinCash - Bob - BobSepolia - Bsc - BscTestnet - Canton - CantonTestnet - Cardano - CardanoPreprod - Concordium - ConcordiumTestnet - Celo - CeloAlfajores - Codex - CodexSepolia - CosmosHub4 - CosmosIcsTestnet - Dogecoin - DogecoinTestnet - Ethereum - EthereumClassic - EthereumClassicMordor - EthereumSepolia - EthereumHolesky - EthereumHoodi - FantomOpera - FantomTestnet - FlareC - FlareCCoston2 - FlowEvm - FlowEvmTestnet - Hedera - HederaTestnet - Ink - InkSepolia - InternetComputer - Ion - IonTestnet - Iota - IotaTestnet - Kaspa - Kusama - KusamaAssetHub - Litecoin - LitecoinTestnet - Near - NearTestnet - Optimism - OptimismSepolia - Origyn - Plasma - PlasmaTestnet - Plume - PlumeSepolia - Paseo - PaseoAssetHub - Polkadot - PolkadotAssetHub - Polygon - PolygonAmoy - Polymesh - PolymeshTestnet - Race - RaceSepolia - SeiAtlantic2 - SeiPacific1 - Solana - SolanaDevnet - Starknet - StarknetSepolia - Stellar - StellarTestnet - Sui - SuiTestnet - Tezos - TezosGhostnet - Tempo - TempoModerato - Tsc - TscTestnet1 - Ton - TonTestnet - Tron - TronNile - Westend - WestendAssetHub - Xdc - XdcApothem - XLayer - XLayerSepolia - XrpLedger - XrpLedgerTestnet BlockchainKind: type: string enum: - Algorand - Aptos - Bitcoin - BitcoinCash - Canton - Cardano - Concordium - Cosmos - Evm - Hedera - Icp - Iota - Kaspa - Near - Polymesh - Solana - Starknet - Stellar - Substrate - Sui - Tezos - Ton - Tron - Xrpl securitySchemes: authenticationToken: type: http scheme: bearer bearerFormat: JWT description: >- **Bearer Token:** Used to authenticate API requests. More details how to generate the token: [Authentication flows](https://docs.dfns.co/api-reference/auth/login-flows) ````