> ## Documentation Index > Fetch the complete documentation index at: https://docs.request.network/llms.txt > Use this file to discover all available pages before exploring further. # Create a new request > Create a new payment request ## OpenAPI ````yaml /api-reference/openapi.v2.json post /v2/request openapi: 3.0.0 info: title: Request Network API description: API for easily creating and paying Requests with Request Network. version: 0.13.0 contact: {} servers: - url: https://api.request.network description: Production server - url: https://api.stage.request.network description: Staging server - url: http://127.0.0.1:8080 description: Local development server security: [] tags: - name: V2/Request description: Core payment request operations (V2) - name: V2/Payments description: Payment search and management operations (V2) - name: V2/Payouts description: Pay a request without creating one first (V2) - name: V2/Payer description: Crypto-to-fiat payer management operations (V2) - name: V2/Currencies description: Currency operations (V2) - name: V2/Client IDs description: Client ID management (V2) - name: V2/Payee Destination description: Payee destination management (V2) externalDocs: description: Request Network Docs url: https://docs.request.network/request-network-api paths: /v2/request: post: tags: - Request - V2/Request summary: Create a new request description: Create a new payment request operationId: RequestControllerV2_createRequest_v2 parameters: - name: x-api-key in: header description: API key for authentication (optional if using Client ID) required: false schema: type: string - name: x-client-id in: header description: Client ID for frontend authentication (optional if using API key) required: false schema: type: string - name: Origin in: header description: >- Origin header (required for Client ID auth, automatically set by browser) required: false schema: type: string requestBody: required: true content: application/json: schema: type: object properties: payer: type: string description: The wallet address of the payer payee: type: string description: >- The wallet address of the payee (Ethereum 0x... or TRON T...). Required for all requests except crypto-to-fiat amount: type: string description: The payable amount of the invoice, in human readable format invoiceCurrency: type: string description: >- Invoice Currency ID, from the [Request Network Token List](https://docs.request.network/general/request-network-token-list) e.g: USD paymentCurrency: type: string description: >- Payment currency ID, from the [Request Network Token List](https://docs.request.network/general/request-network-token-list) e.g: ETH-sepolia-sepolia recurrence: type: object properties: startDate: type: string description: The start date of the invoice, cannot be in the past frequency: type: string enum: - DAILY - WEEKLY - MONTHLY - YEARLY description: The frequency of the invoice required: - startDate - frequency description: The recurrence of the invoice isCryptoToFiatAvailable: type: boolean description: Whether crypto-to-fiat payment is available for this request customerInfo: type: object properties: firstName: type: string minLength: 1 maxLength: 100 description: Customer's first name lastName: type: string minLength: 1 maxLength: 100 description: Customer's last name email: type: string maxLength: 255 format: email description: Customer's email address address: type: object properties: street: type: string maxLength: 255 description: Street address city: type: string maxLength: 100 description: City state: type: string maxLength: 100 description: State or province postalCode: type: string maxLength: 20 description: Postal or ZIP code country: type: string minLength: 2 maxLength: 2 description: Country code (ISO 3166-1 alpha-2) description: Customer's address description: Optional customer information for merchant receipt tracking reference: type: string minLength: 1 maxLength: 255 description: Merchant reference for receipt tracking and identification originalRequestId: type: string minLength: 1 description: ID of the original request for recurring payments originalRequestPaymentReference: type: string minLength: 1 description: >- Payment reference of the original request for recurring payments required: - amount - invoiceCurrency - paymentCurrency examples: regularRequest: summary: Regular payment request value: payee: '0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7' amount: '10' invoiceCurrency: USD paymentCurrency: ETH-sepolia-sepolia cryptoToFiatRequest: summary: Crypto-to-fiat payment request value: amount: '25.50' invoiceCurrency: USD paymentCurrency: USDC-sepolia isCryptoToFiatAvailable: true requestWithCustomerInfo: summary: Request with customer information and reference value: payee: '0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7' amount: '50.00' invoiceCurrency: USD paymentCurrency: USDC-sepolia customerInfo: firstName: John lastName: Doe email: john.doe@example.com address: street: 123 Main Street city: New York state: NY postalCode: '10001' country: US reference: ORDER-2024-001234 recurringInvoice: summary: Recurring invoice value: payee: '0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7' amount: '10' invoiceCurrency: USD paymentCurrency: ETH-sepolia-sepolia recurrence: startDate: '2030-01-01' frequency: YEARLY responses: '201': description: Request created successfully content: application/json: schema: type: object properties: paymentReference: type: string description: >- Unique identifier of the request, used to pay the request as well as check the status of the request example: '0xb3581f0b0f74cc61' requestId: type: string description: >- Unique identifier of the request, commonly used to look up a request in Request Scan example: >- 01e273ecc29d4b526df3a0f1f05ffc59372af8752c2b678096e49ac270416a7cdb '400': description: Validation failed '404': description: Wallet not found '429': description: Too Many Requests ````