> ## Documentation Index
> Fetch the complete documentation index at: https://docs.turnkey.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Turnkey is wallet infrastructure: create and manage crypto wallets, sign transactions, and enforce policy-based access controls. Best-fit uses: embedded consumer wallets (email/passkey/social auth, no seed phrases), automated onchain operations with server-side wallets, AI agent wallets with policy-scoped signing, enterprise key management, and verifiable off-chain workloads on Turnkey Verifiable Cloud (TVC).
> Every API call is a JSON POST to https://api.turnkey.com signed with a P-256 API key; create an organization and key self-serve at https://app.turnkey.com.
> Key Turnkey developer resources: API reference (https://docs.turnkey.com/api-reference/overview/intro.md), OpenAPI spec (https://docs.turnkey.com/public_api.swagger.json), authentication (https://docs.turnkey.com/features/authentication/overview.md), webhooks (https://docs.turnkey.com/features/webhooks/overview.md), MCP server for docs search (https://docs.turnkey.com/mcp), skill for building with Turnkey (https://docs.turnkey.com/skill.md), agent skills for operating an organization (https://docs.turnkey.com/get-started/ai-skills.md), CLI (https://docs.turnkey.com/sdks/cli.md), SDK reference (https://docs.turnkey.com/sdks/introduction.md), full docs content (https://docs.turnkey.com/llms-full.txt).

# Create Fiat On Ramp Session

> Open a fiat on-ramp session for a saved quote.

POST

/

public

/

v1

/

submit

/

create\_fiat\_on\_ramp\_session

Activity requests must meet the [signed-request validity window](https://docs.turnkey.com/api-reference/activities/overview.md#signed-request-validity) for `timestampMs` and the applicable [rate limits](https://docs.turnkey.com/reference/rate-limits.md).

### Authorizations

> [tab] API Key
>
> **X-Stamp** `string` *required*
>
> Cryptographically signed (stamped) request to be passed in as a header. For more info, see [here](https://docs.turnkey.com/developer-reference/api-overview/stamps.md).

> [tab] WebAuthn (Passkey)
>
> **X-Stamp-WebAuthn** `string` *required*
>
> Cryptographically signed (stamped) request to be passed in as a header. For more info, see [here](https://docs.turnkey.com/developer-reference/api-overview/stamps.md).

### Body

**type** `enum\<string\>` *required*

Enum options: `ACTIVITY_TYPE_CREATE_FIAT_ON_RAMP_SESSION`

**timestampMs** `string` *required*

Timestamp (in milliseconds) of the request, used to verify liveness of user requests.

**organizationId** `string` *required*

Unique identifier for a given Organization.

**parameters** `object` *required*

The parameters object containing the specific intent data for this activity.

**details**

Navigate to header

parameters.
quoteId

string

required

Identifier of a saved fiat on-ramp quote. Returned by GetFiatOnRampQuotes.

Navigate to header

parameters.
walletAddress

string

required

Destination wallet address for the buy transaction.

**generateAppProofs** `boolean`

Enable to have your activity generate and return App Proofs, enabling verifiability.

### Response

A successful response returns the following fields:

**activity** `object` *required*

The activity object containing type, intent, and result

**activity details**

Navigate to header

activity.
id

string

required

Unique identifier for a given Activity object.

Navigate to header

activity.
organizationId

string

required

Unique identifier for a given Organization.

Navigate to header

activity.
status

string

required

The activity status

Navigate to header

activity.
type

string

required

The activity type

Navigate to header

activity.
intent

object

required

The intent of the activity

**intent details**

Navigate to header

activity.intent.
createFiatOnRampSessionIntent

object

required

The createFiatOnRampSessionIntent object

**createFiatOnRampSessionIntent details**

Navigate to header

activity.intent.createFiatOnRampSessionIntent.
quoteId

string

required

Identifier of a saved fiat on-ramp quote. Returned by GetFiatOnRampQuotes.

Navigate to header

activity.intent.createFiatOnRampSessionIntent.
walletAddress

string

required

Destination wallet address for the buy transaction.

Navigate to header

activity.
result

object

required

The result of the activity

**result details**

Navigate to header

activity.result.
createFiatOnRampSessionResult

object

required

The createFiatOnRampSessionResult object

**createFiatOnRampSessionResult details**

Navigate to header

activity.result.createFiatOnRampSessionResult.
onRampUrl

string

required

URL of the fiat on-ramp session for the saved quote.

Navigate to header

activity.result.createFiatOnRampSessionResult.
onRampTransactionId

string

required

Unique identifier used to retrieve transaction statuses for a given fiat on-ramp flow.

Navigate to header

activity.
votes

array

required

A list of objects representing a particular User's approval or rejection of a Consensus request, including all relevant metadata.

Navigate to header

activity.
fingerprint

string

required

An artifact verifying a User's action.

Navigate to header

activity.
canApprove

boolean

required

Whether the activity can be approved.

Navigate to header

activity.
canReject

boolean

required

Whether the activity can be rejected.

Navigate to header

activity.
createdAt

string

required

The creation timestamp.

Navigate to header

activity.
updatedAt

string

required

The last update timestamp.

```bash title="cURL" theme={"system"}
curl --request POST \
  --url https://api.turnkey.com/public/v1/submit/create_fiat_on_ramp_session \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header "X-Stamp: <string> (see Authorizations)" \
  --data '{
    "type": "ACTIVITY_TYPE_CREATE_FIAT_ON_RAMP_SESSION",
    "timestampMs": "<string> (e.g. 1746736509954)",
    "organizationId": "<string> (Your Organization ID)",
    "parameters": {
        "quoteId": "<string>",
        "walletAddress": "<string>"
    }
}'
```

```javascript title="JavaScript" theme={"system"}
import { Turnkey } from "@turnkey/sdk-server";

const turnkeyClient = new Turnkey({
  apiBaseUrl: "https://api.turnkey.com",
  apiPublicKey: process.env.API_PUBLIC_KEY!,
  apiPrivateKey: process.env.API_PRIVATE_KEY!,
  defaultOrganizationId: process.env.ORGANIZATION_ID!,
});

const response = await turnkeyClient.apiClient().createFiatOnRampSession({
  quoteId: "<string> (Identifier of a saved fiat on-ramp quote. Returned by GetFiatOnRampQuotes.)",
  walletAddress: "<string> (Destination wallet address for the buy transaction.)"
});
```

```json 200 theme={"system"}
{
  "activity": {
    "id": "<activity-id>",
    "status": "ACTIVITY_STATUS_COMPLETED",
    "type": "ACTIVITY_TYPE_CREATE_FIAT_ON_RAMP_SESSION",
    "organizationId": "<organization-id>",
    "timestampMs": "<timestamp> (e.g. 1746736509954)",
    "result": {
      "activity": {
        "id": "<string>",
        "organizationId": "<string>",
        "status": "<string>",
        "type": "<string>",
        "intent": {
          "createFiatOnRampSessionIntent": {
            "quoteId": "<string>",
            "walletAddress": "<string>"
          }
        },
        "result": {
          "createFiatOnRampSessionResult": {
            "onRampUrl": "<string>",
            "onRampTransactionId": "<string>"
          }
        },
        "votes": "<array>",
        "fingerprint": "<string>",
        "canApprove": "<boolean>",
        "canReject": "<boolean>",
        "createdAt": "<string>",
        "updatedAt": "<string>"
      }
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.