Skip to main content
Solved

Full Swagger vs. one per endpoint

  • Apr 20, 2026 6:25 PM UTC
  • 3 replies
  • 104 views
  • Translate All

Forum|alt.badge.img

I know there are a lot of endpoints, but is there a way to get a single swagger file for Acumatica’s REST API, or must I get one per endpoint? 

Best answer by Dmitrii Naumov

It’s one per endpoint. But you probably only need just one. I’d suggest to start with the Default endpoint and see if that covers all your needs.

View original

3 replies

Dmitrii Naumov
Community Manager
Forum|alt.badge.img+7
  • Community Manager
  • Answer
  • Apr 20, 2026 6:27 PM UTC

It’s one per endpoint. But you probably only need just one. I’d suggest to start with the Default endpoint and see if that covers all your needs.

Translate

Forum|alt.badge.img+4
  • Captain II
  • Apr 21, 2026 11:58 AM UTC

You must generate one Swagger file per endpoint — there is no built-in way to get a single combined Swagger file for all endpoints.
 

Each endpoint in Acumatica represents a specific contract/version (e.g., Default/22.200.001, CustomEndpoint/23.100.001)

Endpoints can have:

Different DACs exposed

Different field mappings

Different permissions / structures

Swagger is available
/entity/<EndpointName>/<Version>/$swagger
Example
/entity/Default/22.200.001/$swagger

Translate

Forum|alt.badge.img
  • Author
  • Jr Varsity III
  • Apr 22, 2026 3:06 PM UTC

Thankyou

Translate