Skip to main content
Question

Full Swagger vs. one per endpoint

  • April 20, 2026
  • 3 replies
  • 42 views

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? 

3 replies

Dmitrii Naumov
Acumatica Moderator
Forum|alt.badge.img+7
  • Acumatica Moderator
  • April 20, 2026

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.


Forum|alt.badge.img
  • Varsity I
  • April 21, 2026

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


  • Author
  • Freshman II
  • April 22, 2026

Thankyou