# Introduction & Quick Start ## Docs - [Validate corporate ACH account](https://docs.revolv3.com/api-reference/accountverification/validate-corporate-ach-account.md): Validates a **corporate (business) ACH bank account** to ensure it can be used for payment processing and payouts. This endpoint is commonly used when onboarding business merchants or partners to confirm that their company’s bank account and routing information are valid before linking it to paym… - [Validate personal ACH account](https://docs.revolv3.com/api-reference/accountverification/validate-personal-ach-account.md): Validates a **personal ACH bank account** to confirm that it can be used for electronic payments. This endpoint is typically used during customer onboarding or before initiating the first ACH transaction to ensure the provided account number and routing number are correct and accepted by the syst… - [Get Merchant Access Token](https://docs.revolv3.com/api-reference/authentication/get-merchant-access-token.md): Generates an **access token** used to authenticate API requests on behalf of a specific merchant. This endpoint is typically called as part of the login or credential exchange process and requires valid client credentials (Merchant Client ID, Developer API Key), which can be generated in the Mercha… - [Create Checkout Link](https://docs.revolv3.com/api-reference/checkout/create-checkout-link.md): Generates a **secure, one-time checkout link** that can be shared with a customer to initiate a payment. This URL can be seamlessly integrated into your payment flow — embedded into your payment page, or used to redirect customers to a hosted payment page managed by the platform. The link is aut… - [Get Complete Checkout Information](https://docs.revolv3.com/api-reference/checkout/get-complete-checkout-information.md): Retrieves **all available details** about a specific checkout session using its unique identifier. This includes the customer information, transaction status, payment method used, transaction details. It is typically used after a checkout has been completed, allowing the merchant to verify the res… - [Add Customer Address](https://docs.revolv3.com/api-reference/customers/add-customer-address.md): Adds a **new billing or shipping address** to an existing customer profile. The address can later be used for billing calculations, tax reporting, or to associate with subscriptions and invoices. This endpoint is commonly used during onboarding or when a customer adds additional addresses to their… - [Create Customer](https://docs.revolv3.com/api-reference/customers/create-customer.md): Creates a **new customer** record within your merchant account. You can provide customer details such as first name, last name, billing address, shipping address, and a Merchant Customer Ref ID (an external identifier you define). Once created, the customer can be linked to subscriptions, paymen… - [Delete Customer](https://docs.revolv3.com/api-reference/customers/delete-customer.md): Marks a **customer record as inactive**, preventing further transactions or modifications. This soft-delete approach ensures that the customer is no longer active in your environment but preserves historical data (e.g., transactions, invoices) for reporting and compliance purposes. **Personal da… - [Delete Customer Address](https://docs.revolv3.com/api-reference/customers/delete-customer-address.md): Removes a **saved billing or shipping address** associated with a specific customer profile. This is typically used when a customer no longer uses a particular address or wishes to replace it. Only the specified address is removed — the customer profile and other addresses (if any) remain intact. - [Get Customer](https://docs.revolv3.com/api-reference/customers/get-customer.md): Retrieves the **full details of a specific customer** using their unique Customer ID. The response includes personal information (first name, last name), billing and shipping addresses, merchant customer reference ID, and linked data. This endpoint is useful for displaying customer profiles, val… - [Get Customers](https://docs.revolv3.com/api-reference/customers/get-customers.md): Retrieves a **list of customers** associated with your merchant account. You can search for a specific customer using filters such as **Merchant Customer Ref ID**, **first name**, or **last name**. The response includes key details for each matching customer — such as first name, last name, cust… - [Get Subscriptions by Customer](https://docs.revolv3.com/api-reference/customers/get-subscriptions-by-customer.md): Retrieves a **list of all subscriptions** linked to a specific customer, identified by their Customer ID. This includes active, or cancelled subscriptions — each with details such as billing plan, billing cycle, status, and payment method. The endpoint is typically used to display a customer's s… - [Search Invoices for Customer](https://docs.revolv3.com/api-reference/customers/search-invoices-for-customer.md): Searches for **invoices associated with a specific customer**, using optional filters such as **Merchant Customer Ref ID**, **Merchant Invoice Ref ID**, **start date**, and **end date**. The filter applies to the **billing date** of each invoice. Results are returned in a paginated format using… - [Update Address](https://docs.revolv3.com/api-reference/customers/update-address.md): Updates the **details of an existing customer address**, such as street, city, postal code, or country. Only the fields provided in the request will be updated — others will remain unchanged. This endpoint is commonly used when a customer changes residence, corrects an error in their address, or… - [Update Customer](https://docs.revolv3.com/api-reference/customers/update-customer.md): Updates the **details of an existing customer**, such as their first name, last name, or merchant customer reference ID. Only the fields provided in the request will be updated — all other customer data remains unchanged. This endpoint is typically used when customers change their names, correct… - [Get Invoice](https://docs.revolv3.com/api-reference/invoices/get-invoice.md): Retrieves detailed information about a **specific invoice** using its unique invoice ID. This endpoint returns invoice metadata, payment status, amount, associated payment method references, and timestamps related to invoice attempts. It’s ideal when you already know the invoice ID and need to f… - [Get Invoices](https://docs.revolv3.com/api-reference/invoices/get-invoices.md): Retrieves a **list of all invoices** across your merchant account, with optional filtering by **Merchant Customer Ref ID**, **Merchant Invoice Ref ID**, **start date**, and **end date**. Date filters apply to the invoice’s **billing date**. The endpoint supports pagination via **Page** and **Pag… - [Get Invoices V1](https://docs.revolv3.com/api-reference/invoices/get-invoices-v1.md): Returns a **detailed list of invoices** using the latest version of our invoice retrieval logic. This endpoint provides comprehensive invoice information, including status, payment attempts, raw processor responses (if enabled), and additional filtering options available beyond the legacy version.… - [One Time Payment Without Subscription](https://docs.revolv3.com/api-reference/invoices/one-time-payment-without-subscription.md): Processes a **one-time payment** for a customer without requiring an active subscription. This endpoint is ideal for standalone transactions such as single purchases. A one-time payment without a subscription allows you to both authorize and capture funds in a single transaction, as well as capt… - [Refund Invoice](https://docs.revolv3.com/api-reference/invoices/refund-invoice.md): Initiates a **refund** for a previously paid invoice. This endpoint allows full or partial refunds, depending on the amount specified in the request. You must supply the unique `invoiceId` of the transaction to be refunded, along with the refund amount (for partial refund). The system validates… - [Authorize Payment Method](https://docs.revolv3.com/api-reference/paymentmethod/authorize-payment-method.md): Performs a payment authorization for a specified amount on a stored payment method or provided card, without capturing the funds. This is typically used to verify that the card or bank account is valid, has sufficient funds, and is accepted by the processor. You define the authorization amount,… - [Create Payment Method](https://docs.revolv3.com/api-reference/paymentmethod/create-payment-method.md): Creates and stores a **new payment method** for a customer, such as a credit card, ACH account, or digital wallet token. This endpoint accepts full payment method details and securely tokenizes them for future use. It’s typically used during onboarding, checkout, or when a customer wants to add… - [Delete Payment Method](https://docs.revolv3.com/api-reference/paymentmethod/delete-payment-method.md): Marks a **stored payment method as inactive** using its unique identifier. The method is no longer available for future charges, including subscriptions and one-time payments, but is **not physically deleted** from the system. This approach allows for historical consistency in billing and audit… - [Get Payment Method](https://docs.revolv3.com/api-reference/paymentmethod/get-payment-method.md): Retrieves details about a **specific stored payment method**, using its unique identifier. The response includes type (e.g., credit card, ACH), masked account details, expiration, and billing address. This endpoint is commonly used to display payment method information in the UI (e.g., "Visa end… - [Reverse Authorization](https://docs.revolv3.com/api-reference/paymentmethod/reverse-authorization.md): Cancels a **previously authorized** payment before it has been captured. This is typically used to release a hold placed on the customer's account — for example, when an order is canceled or the final amount is still uncertain. The endpoint requires the original `paymentMethodAuthorizationId`, a… - [Update Payment Method Billing Address](https://docs.revolv3.com/api-reference/paymentmethod/update-payment-method-billing-address.md): Updates the **billing address** associated with a stored payment method. You can modify fields such as street, city, postal code, region, or country, without needing to re-enter the full payment method details. This endpoint is useful when a customer moves, changes billing information, or correc… - [Authorize With Payment Method Details](https://docs.revolv3.com/api-reference/payments/authorize-with-payment-method-details.md): Performs a **payment authorization** using raw payment method details (e.g., card number, expiration date, CVV, or bank account info), without capturing the funds immediately. This is typically used when you want to place a hold on the customer’s account — for example, to confirm availability of fu… - [Authorize With Payment Method Id](https://docs.revolv3.com/api-reference/payments/authorize-with-payment-method-id.md): Performs a **payment authorization** using a previously stored payment method, referenced by its unique ID. The funds are held on the customer’s account but **not captured** immediately. This endpoint is typically used in multi-step checkout flows, bookings, or delayed fulfillment scenarios. It… - [Capture](https://docs.revolv3.com/api-reference/payments/capture.md): Captures funds from a **previously authorized transaction**, completing the payment. Use this endpoint when you've already authorized a payment, and now want to finalize the charge. You must provide the `paymentMethodAuthorizationId` - original authorization reference. The amount captured can b… - [Sale With Payment Method Details](https://docs.revolv3.com/api-reference/payments/sale-with-payment-method-details.md): Processes a **direct sale transaction** using full payment method details (e.g., card number, expiry, CVV, ACH info). This is a one-step charge operation — the payment is authorized and captured immediately. You must provide customer and invoice details along with raw payment data. This method… - [Sale With Payment Method Id](https://docs.revolv3.com/api-reference/payments/sale-with-payment-method-id.md): Processes a **sale transaction** using a previously stored payment method, referenced by its unique ID. This is a one-step payment operation that **authorizes and captures funds** in a single call. You must provide the `paymentMethodId`, along with invoice, and amount details. This endpoint is… - [Void](https://docs.revolv3.com/api-reference/payments/void.md) - [Cancel Subscription](https://docs.revolv3.com/api-reference/subscriptions/cancel-subscription.md): Cancels an active subscription, stopping all future billing and scheduled invoices. This endpoint allows for **controlled cancellation logic**, such as canceling immediately. You must provide the `subscriptionId`. This is commonly used in customer self-service flows, churn-prevention workflows,… - [Create One Time Payment](https://docs.revolv3.com/api-reference/subscriptions/create-one-time-payment.md): Creates and processes a **one-time payment under an existing subscription context**, outside of the regular billing schedule. This is useful for charging a subscriber for additional services, setup fees, usage overages, or one-off adjustments without altering the subscription plan itself. You mu… - [Create Subscription](https://docs.revolv3.com/api-reference/subscriptions/create-subscription.md): Creates a **new subscription** for a customer, linking a recurring billing plan to their payment method. You must provide details such as the customer, start date, and payment method. Once created, the system will automatically generate invoices and process payments based on the defined billing… - [Create Subscription Billing Plan](https://docs.revolv3.com/api-reference/subscriptions/create-subscription-billing-plan.md): Creates a **new subscription billing plan** that defines the terms for recurring charges — including amount, frequency, and optional trial configuration. You must provide details such as plan name and amount. Optional fields include billing plan CycleCount, billing plan ValueType, and billing pla… - [Delete Subscription Billing Plan](https://docs.revolv3.com/api-reference/subscriptions/delete-subscription-billing-plan.md): Deletes a **subscription billing plan** that is no longer needed. This operation is allowed only if the plan is **not currently associated with any active subscriptions**. It’s typically used during cleanup, testing, or deprecation of old pricing tiers. Attempting to delete a plan that is still… - [Get Subscription](https://docs.revolv3.com/api-reference/subscriptions/get-subscription.md): Retrieves **detailed information about a specific subscription**, using its unique subscription ID. The response includes customer reference, billing plan details, billing interval, next billing date, and associated payment method. This endpoint is commonly used to display subscription data in c… - [Get Subscriptions](https://docs.revolv3.com/api-reference/subscriptions/get-subscriptions.md): Retrieves a list of **all subscriptions** under your merchant account. This includes active and cancelled subscriptions — each returned with metadata such as customer reference, billing interval, billing plan details, and next billing date. It’s typically used to display subscription summaries. - [Get Subscriptions By PAN](https://docs.revolv3.com/api-reference/subscriptions/get-subscriptions-by-pan.md): Searches for and returns **subscriptions associated with a specific PAN (Primary Account Number)** — the full card number. This endpoint is useful for backend support or migration scenarios where subscriptions need to be located based on card information, especially across multiple customer profile… - [Replace Subscription Primary Payment Method](https://docs.revolv3.com/api-reference/subscriptions/replace-subscription-primary-payment-method.md): Replaces the **primary payment method** associated with an active subscription. This operation is typically used when a customer updates their card, bank account, or switches to a different saved method for ongoing billing. You must provide the `subscriptionId` and the new payment method details… - [Update Subscription](https://docs.revolv3.com/api-reference/subscriptions/update-subscription.md): Updates the configuration of an existing **active subscription**. You can change properties such as the MerchantSubscriptionRefId, billing frequency, SubscriptionStatusType, SubscriptionCancelType, or next billing date without needing to cancel or recreate the subscription. This endpoint is typ… - [Revolv3 Updates](https://docs.revolv3.com/changelog.md): Revolv3 Product Updates - [API Reference](https://docs.revolv3.com/docs/api-reference/api-reference.md): High-level overview of API endpoint groups. Understand what each group does and when to use it, then dive into the OpenAPI spec for detailed documentation. - [Revolv3 Appendix](https://docs.revolv3.com/docs/appendix/appendix-revolv3.md): Concise reference: contacts, glossary, common resources, and quick operational notes. - [Authentication](https://docs.revolv3.com/docs/authentication-security/merchant-access-token.md): Learn how to obtain and use your static token (`x-revolv3-token`) to authenticate with the Revolv3 API, including environment setup, required headers, examples, and legacy guidance. - [Security Best Practices](https://docs.revolv3.com/docs/authentication-security/security-best-practices.md): Essential security guidance for API integrations. Learn how to safely handle API tokens, protect sensitive data, and avoid common security pitfalls. - [Token FAQ](https://docs.revolv3.com/docs/authentication-security/token-faq.md): Common questions about payment tokens, network tokens, processor tokens, and how Revolv3 handles tokenization. Clear explanations for developers. - [Certification & Go-Live Checklist](https://docs.revolv3.com/docs/certification-go-live/checklist.md): Pre-launch requirements, mandatory test cases, production enablement process, and contact points for Revolv3 certification and go-live. - [Revolv3 Checkout Integration](https://docs.revolv3.com/docs/checkout/checkout.md): Learn about Revolv3's secure checkout options. Choose between hosted pages or embedded checkout to collect payments without handling sensitive card data yourself. - [Core Concepts & Data Models Overview](https://docs.revolv3.com/docs/core-concepts/core-concepts-overview.md): High-level overview of Revolv3 entities: Merchant, Customer, PaymentMethod, Invoice, Attempt, Subscription. Learn how they relate and where to find detailed guides. - [Customer](https://docs.revolv3.com/docs/core-concepts/customer/customer.md): Learn when and why to use customer records in Revolv3. Understand how customers work, when they're optional, and how to use them effectively. - [Forward 3D Secure Parameters to Processors](https://docs.revolv3.com/docs/core-concepts/invoice/3ds-pass.md): Learn how to include 3D Secure (3DS) authentication results in your payment requests when using an external 3DS provider. Improve security and reduce fraud. - [Dynamic Descriptor Guide](https://docs.revolv3.com/docs/core-concepts/invoice/dynamic-descriptor-guide.md): Customize what appears on customer credit card statements using dynamic descriptors. Reduce chargebacks and improve customer recognition of charges. - [Get Invoice Details](https://docs.revolv3.com/docs/core-concepts/invoice/get-details-of-invoice-attempts.md): Retrieve detailed information about a specific invoice, including all payment attempts, full payment method details, and processor responses. - [Get Invoices API](https://docs.revolv3.com/docs/core-concepts/invoice/get-invoices-api.md): Learn how to retrieve a list of invoices with filtering and pagination. Understand when to use this endpoint and how to get detailed invoice information. - [Invoice Export](https://docs.revolv3.com/docs/core-concepts/invoice/invoice-export.md): Export invoices to CSV for reporting, accounting, and reconciliation. Learn how to use the invoice export feature in the Revolv3 portal. - [Network Processing Types](https://docs.revolv3.com/docs/core-concepts/invoice/network-processing-types.md): Understand how to classify transactions as initial, recurring, or installment payments. Learn why this matters and how it affects payment processing. - [Processor Raw Response](https://docs.revolv3.com/docs/core-concepts/invoice/processor-raw-response.md): Learn how to retrieve detailed raw responses from payment processors for debugging, auditing, and accessing processor-specific codes and messages. - [Merchant Settings](https://docs.revolv3.com/docs/core-concepts/merchants/merchant-setting.md): Understand merchant-level settings that affect how payments are processed. Learn about defaults, processor configuration, and feature toggles. - [Order Processing Channel](https://docs.revolv3.com/docs/core-concepts/merchants/order-processing-channels.md): Learn about order processing channels (e-commerce vs mail/telephone order). Understand when to use each channel and how it affects payment processing. - [Account Updater](https://docs.revolv3.com/docs/core-concepts/paymentmethod/account-updater.md): Learn how Account Updater automatically keeps stored credit card information current. Understand when cards are updated and how to handle update notifications. - [ACH Direct Debit Payments](https://docs.revolv3.com/docs/core-concepts/paymentmethod/ach-direct-debit.md): Learn what ACH is, why it takes days to process, and when to use it. Perfect for recurring bills, subscriptions, and large transactions where the delay is acceptable. - [Managing Billing Addresses](https://docs.revolv3.com/docs/core-concepts/paymentmethod/billing-address.md): Learn how to format and validate billing addresses for payment processing. Understand address requirements, validation rules, and international address formats. - [Create a Payment Method](https://docs.revolv3.com/docs/core-concepts/paymentmethod/paymentmethod-guide.md): Learn how to securely store customer payment methods using tokenization, and reuse them for future transactions without handling sensitive card data. - [Using Apple Pay](https://docs.revolv3.com/docs/core-concepts/paymentmethod/using-applepay.md): Learn how to accept Apple Pay payments through Revolv3. Understand the setup process, how to pass Apple Pay tokens, and handle responses. - [Using Google Pay](https://docs.revolv3.com/docs/core-concepts/paymentmethod/using-googlepay.md): Accept Google Pay payments through Revolv3 using gateway-based tokenization (PAYMENT_GATEWAY). Includes Worldpay (Vantiv) examples, environment setup, and architecture diagrams. - [Subscription Billing Plans](https://docs.revolv3.com/docs/core-concepts/subscription/billing-plans.md): Learn how to create flexible subscription billing plans with different pricing, cycles, and value types. Understand how billing plans work together. - [Canceling a Subscription](https://docs.revolv3.com/docs/core-concepts/subscription/canceling-a-subscription.md): Learn how to cancel customer subscriptions, understand immediate vs end-of-cycle cancellation, and handle refunds for canceled subscriptions. - [Create a Subscription](https://docs.revolv3.com/docs/core-concepts/subscription/create-subscription.md): Learn how to set up recurring billing for subscription services, memberships, and recurring payments. Understand billing cycles, trials, and subscription management. - [Invoice Line Items & Subscription Plans](https://docs.revolv3.com/docs/core-concepts/subscription/invoice-line-items-subscription-plans.md): Understand how invoice line items and subscription billing plans work together to create structured billing for one-time charges and recurring payments. - [Decline Codes Reference](https://docs.revolv3.com/docs/error-codes/decline-codes.md): A comprehensive reference for Revolv3 API payment decline codes. Understand why a transaction failed and how to handle the error. - [Revolv3 API Response Codes and Errors](https://docs.revolv3.com/docs/error-codes/error-responses.md): Comprehensive reference for HTTP status codes and error responses in the Revolv3 API. - [Revolv3 FAQ](https://docs.revolv3.com/docs/faq.md): Answers to common questions about Revolv3 API authentication, errors, environments, network transaction IDs, tokenization, and support. - [Getting Started with Revolv3](https://docs.revolv3.com/docs/getting-started/getting-started.md): Your first guide to integrating with the Revolv3 API. Covers authentication, sandbox testing, and making your first API call successfully. - [Postman Collection](https://docs.revolv3.com/docs/getting-started/links-to-postman.md): Access Revolv3's Postman collections for easy API testing. Learn how to get the collections and use them to test your integration. - [Step-by-step "Make a Payment" example](https://docs.revolv3.com/docs/getting-started/make-a-payment.md): Learn how to process a payment with a real-world e-commerce scenario. Understand what happens behind the scenes when you charge a customer. - [Production Environment Limitations](https://docs.revolv3.com/docs/getting-started/production-limitations.md): Understand API rate limits and throttling for production. Learn the limits, what happens when you exceed them, and how to handle rate limit errors. - [Production Environment vs Sandbox Environment](https://docs.revolv3.com/docs/getting-started/production-vs-sandbox.md): Understand the differences between Revolv3's production and sandbox environments, when to use each, and how to switch from testing to live payments. - [ACH Payment Flow](https://docs.revolv3.com/docs/integration-flows/ach-payment-flow.md): End-to-end ACH payment flow: verification and settlement. Sequence diagram and how timing differs from card payments. Links to ACH direct debit and test data. - [Payment Authorizations & Captures](https://docs.revolv3.com/docs/integration-flows/authorizations-captures.md): Learn when and why to use the two-step authorization and capture flow. Perfect for hotels, pre-orders, and scenarios where you need to reserve funds before charging. - [Card Payment Flow](https://docs.revolv3.com/docs/integration-flows/card-payment-flow.md): End-to-end card payment flow: sale vs auth/capture. Sequence diagrams and sample requests for immediate charge and two-step authorize-then-capture. - [Network Token Fallback Flow](https://docs.revolv3.com/docs/integration-flows/network-token-fallback-flow.md): How Revolv3 uses network tokens, processor tokens, and PAN as fallbacks to maximize approval rates and resilience when processing card payments. - [Processing Refunds](https://docs.revolv3.com/docs/integration-flows/refunds.md): Learn when and how to issue refunds, including full and partial refunds. Understand refund scenarios, timing, and how to handle returns in your application. - [Subscription Flow](https://docs.revolv3.com/docs/integration-flows/subscription-flow.md): End-to-end subscription flow: create, renew, and cancel. Sequence diagrams and links to billing plans, recycling, and cancellation guides. - [Subscription Status and Recycling](https://docs.revolv3.com/docs/integration-flows/subscription-status-recycling.md): Once a subscription is created, it can exist in one of several statuses. Revolv3 provides recycling to handle failed payments and optimize recurring billing. - [Shopify Integration](https://docs.revolv3.com/docs/plugins/shopify.md): Integrate Shopify checkout with Revolv3 using a Custom Payment App (Credit Card Payment Extension). - [FAQ](https://docs.revolv3.com/docs/plugins/shopify-faq.md): Frequently asked questions about using Revolv3 with Shopify. - [Quick Start](https://docs.revolv3.com/docs/plugins/shopify-quick-start.md): Set up Revolv3 as a payment provider in Shopify and activate payments. - [Security & Compliance](https://docs.revolv3.com/docs/plugins/shopify-security-compliance.md): How Revolv3 keeps Shopify card data secure and minimizes PCI scope. - [Sandbox Environment Limitations](https://docs.revolv3.com/docs/testing-sandbox/sandbox-environment-limitations.md): Understand the limitations and constraints of the Revolv3 sandbox environment. Learn about data retention, maintenance windows, and transaction limits. - [Test ACH for Account Verification](https://docs.revolv3.com/docs/testing-sandbox/test-ach-for-validate-person.md): Test data for ACH account verification in sandbox. Use these test values to verify bank accounts before processing ACH payments. - [Test Cards for Sandbox](https://docs.revolv3.com/docs/testing-sandbox/test-cards-for-sandbox.md): Complete list of test credit card numbers for the Revolv3 sandbox. Test different payment scenarios, responses, and decline codes safely. - [Creating a Webhook](https://docs.revolv3.com/docs/webhook-events/creating-a-webhook.md): Step-by-step guide to creating and configuring webhooks in the Revolv3 portal. Learn how to set up your endpoint and verify it works. - [Webhooks Guide](https://docs.revolv3.com/docs/webhook-events/webhook.md): Learn how to receive real-time notifications from Revolv3 via webhooks. Understand webhook events, how to verify signatures, and handle different event types. ## OpenAPI Specs - [swagger](https://docs.revolv3.com/api-reference/swagger.json) - [openapi](https://docs.revolv3.com/openapi.json) - [swagger-chatgpt1](https://docs.revolv3.com/swagger-chatgpt1.json) - [swagger-nodesc](https://docs.revolv3.com/swagger-nodesc.json) - [prevswagger](https://docs.revolv3.com/prevswagger.json)