AMCS Group SaveLocation API

The SaveLocation API from AMCS Group — 2 operation(s) for savelocation.

Operations 2

POST /directory/saveLocations Create or update #
PUT /directory/saveLocations/{guid} Partial update #

Specifications

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/amcs-group-savelocation-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

amcs-group-savelocation-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Core AccessGroup Save Location API
  version: core
servers:
- url: https://rstapi-sbx-svc-core.amcsplatform.com/erp/api/integrator/erp
  description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: SaveLocation
paths:
  /directory/saveLocations:
    post:
      tags:
      - SaveLocation
      summary: Create or update
      description: '| Property| Description| Required |

        | ----------------------------- | ------------------------------------------------------------------------------------------------------------- | -------- |

        | GUID| The GUID associated to the customer.| No |

        | Description| The description associated to the location.| Yes |

        | TimeZone| The TimeZone associated to the location.| No |

        | LegalName| The LegalName associated to the location.| No |

        | Directions| The Directions associated to the location.| No |

        | UniqueReference| The UniqueReference associated to the location.| No |

        | Acreage| The Acreage associated to the location.| No |

        | Address| The Address object associated to the location.| Yes |

        | Address.HouseNumber| The HouseNumber associated address object of the location.| No |

        | Address.Address1| The Address1 associated to the address object of the location.| No |

        | Address.Address2| The Address2 associated to the address object of the location.| No |

        | Address.Address3| The Address3 associated to the address object of the location.| No |

        | Address.Address4| The Address4 associated to the address object of the location.| No |

        | Address.Address5| The Address5 associated to the address object of the location.| No |

        | Address.Address6| The Address6 associated to the address object of the location.| No |

        | Address.Address7| The Address7 associated to the address object of the location.| No |

        | Address.Address8| The Address8 associated to the address object of the location.| No |

        | Address.Address9| The Address9 associated to the address object of the location.| No |

        | Address.Postcode| The Postcode associated to the address object of the location.| No |

        | Address.PostTownListItem| The GUID and post town associated to the address object of the location.| No |

        | Address.RegionCodeListItem| The GUID and region code associated to the address object of the location.| No |

        | Address.ContactMethods| The ContactMethods object associated to the address object of the location.| No |

        | Address.ContactMethods.TelNo| The telephone number object associated to the ContactMethods object of the address object of the location.| No |

        | Address.ContactMethods.FaxNo| The fax number object associated to the ContactMethods object of the address object of the location.| No |

        | Geo| The Geo object associated to the location.| No |

        | Geo.ZoneListItem| The GUID and description of the zone associated to the Geo object of the location.| No |

        | Geo.ParcelBoundaryListItem| The GUID and description of the parcel boundary associated to the Geo object of the location.| No |

        | Geo.Location| The location object associated to the Geo object of the location.| No |

        | Geo.Location.Lat| The latitude associated to the location object associated to the Geo object of the location.| No |

        | Geo.Location.Long| The longitude associated to the location object associated to the Geo object of the location.| No |

        | Geo.Latitude| The latitude associated to the Geo object of the location.| No |

        | Geo.Longitude| The longitude associated to the Geo object of the location.| No |

        | IsDeleted| Whether the location is deleted.| No |


        **Extra validations**


        | Condition| Error message |

        | ------------------------------------------------------------------------------------------------------------- | ------------- |

        | TimeZone has a value| TimeZone must be set to null. |

        | If IsDeleted true| IsDeleted is TRUE. Could not process the request. Resources can not be deleted via the REST API. |

        | If we attempt to delete a Location| An attempt has been made to set IsDeleted. The request could not be processed. Ensure that IsDeleted has default value. |

        | Geo.Location has a value| Geo.Location must be set to null. |

        | Geo.Latitude value not in range between -90 and 90 or Geo.Longitude value not in range between -180 and 180| Geo.Latitude value must be between -90 and 90. Geo.Longitude value must be between -180 and 180. |'
      operationId: SaveLocation_Create
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApiIntegratorSaveLocationResource'
        required: true
        x-bodyName: null
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiResourceId'
  /directory/saveLocations/{guid}:
    put:
      tags:
      - SaveLocation
      summary: Partial update
      description: '| Property| Description| Required |

        | ----------------------------- | ------------------------------------------------------------------------------------------------------------- | -------- |

        | GUID| The GUID associated to the customer.| No |

        | Description| The description associated to the location.| Yes |

        | TimeZone| The TimeZone associated to the location.| No |

        | LegalName| The LegalName associated to the location.| No |

        | Directions| The Directions associated to the location.| No |

        | UniqueReference| The UniqueReference associated to the location.| No |

        | Acreage| The Acreage associated to the location.| No |

        | Address| The Address object associated to the location.| Yes |

        | Address.HouseNumber| The HouseNumber associated address object of the location.| No |

        | Address.Address1| The Address1 associated to the address object of the location.| No |

        | Address.Address2| The Address2 associated to the address object of the location.| No |

        | Address.Address3| The Address3 associated to the address object of the location.| No |

        | Address.Address4| The Address4 associated to the address object of the location.| No |

        | Address.Address5| The Address5 associated to the address object of the location.| No |

        | Address.Address6| The Address6 associated to the address object of the location.| No |

        | Address.Address7| The Address7 associated to the address object of the location.| No |

        | Address.Address8| The Address8 associated to the address object of the location.| No |

        | Address.Address9| The Address9 associated to the address object of the location.| No |

        | Address.Postcode| The Postcode associated to the address object of the location.| No |

        | Address.PostTownListItem| The GUID and post town associated to the address object of the location.| No |

        | Address.RegionCodeListItem| The GUID and region code associated to the address object of the location.| No |

        | Address.ContactMethods| The ContactMethods object associated to the address object of the location.| No |

        | Address.ContactMethods.TelNo| The telephone number object associated to the ContactMethods object of the address object of the location.| No |

        | Address.ContactMethods.FaxNo| The fax number object associated to the ContactMethods object of the address object of the location.| No |

        | Geo| The Geo object associated to the location.| No |

        | Geo.ZoneListItem| The GUID and description of the zone associated to the Geo object of the location.| No |

        | Geo.ParcelBoundaryListItem| The GUID and description of the parcel boundary associated to the Geo object of the location.| No |

        | Geo.Location| The location object associated to the Geo object of the location.| No |

        | Geo.Location.Lat| The latitude associated to the location object associated to the Geo object of the location.| No |

        | Geo.Location.Long| The longitude associated to the location object associated to the Geo object of the location.| No |

        | Geo.Latitude| The latitude associated to the Geo object of the location.| No |

        | Geo.Longitude| The longitude associated to the Geo object of the location.| No |

        | IsDeleted| Whether the location is deleted.| No |


        **Extra validations**


        | Condition| Error message |

        | ------------------------------------------------------------------------------------------------------------- | ------------- |

        | If TimeZone value has been changed| TimeZone is a read-only property |

        | If IsDeleted true| IsDeleted is TRUE. Could not process the request. Resources can not be deleted via the REST API. |

        | If we attempt to delete a Location| An attempt has been made to set IsDeleted. The request could not be processed. Ensure that IsDeleted has default value. |

        | If Geo.Location.Lat value has been changed| Geo.Location.Lat is a read-only property |

        | If Geo.Location.Long value has been changed| Geo.Location.Long is a read-only property |

        | Geo.Latitude value not in range between -90 and 90 or Geo.Longitude value not in range between -180 and 180| Geo.Latitude value must be between -90 and 90. Geo.Longitude value must be between -180 and 180. |'
      operationId: SaveLocation_Update
      parameters:
      - name: guid
        in: path
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApiIntegratorSaveLocationResource'
        required: true
        x-bodyName: null
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiResourceId'
components:
  schemas:
    ApiResourceId:
      type: object
      properties:
        resource:
          type: string
          format: uuid
        errors:
          $ref: '#/components/schemas/ApiResourceErrors'
        status:
          $ref: '#/components/schemas/ApiResourceStatus'
    ApiResourceStatus:
      type: object
      properties:
        id:
          type: integer
          format: int32
        isSuccess:
          type: boolean
    ApiIntegratorLocationGeoResource:
      type: object
      properties:
        ZoneListItem:
          $ref: '#/components/schemas/ApiIntegratorListItemResource'
        ParcelBoundaryListItem:
          $ref: '#/components/schemas/ApiIntegratorListItemResource'
        Location:
          $ref: '#/components/schemas/ApiIntegratorLocationGeoLocationResource'
        Latitude:
          type: number
          format: double
        Longitude:
          type: number
          format: double
    ApiResourceErrors:
      type: object
      properties:
        errors:
          type: string
    ApiIntegratorLocationGeoLocationResource:
      type: object
      properties:
        Lat:
          type: number
          format: double
        Long:
          type: number
          format: double
    ApiIntegratorLocationAddressContactMethodsResource:
      type: object
      properties:
        TelNo:
          type: string
        FaxNo:
          type: string
    ApiIntegratorLocationAddressResource:
      type: object
      properties:
        HouseNumber:
          type: string
        Address1:
          type: string
        Address2:
          type: string
        Address3:
          type: string
        Address4:
          type: string
        Address5:
          type: string
        Address6:
          type: string
        Address7:
          type: string
        Address8:
          type: string
        Address9:
          type: string
        Postcode:
          type: string
        ContactMethods:
          $ref: '#/components/schemas/ApiIntegratorLocationAddressContactMethodsResource'
        PostTownListItem:
          $ref: '#/components/schemas/ApiIntegratorListItemResource'
        RegionCodeListItem:
          $ref: '#/components/schemas/ApiIntegratorListItemResource'
    ApiIntegratorSaveLocationResource:
      type: object
      properties:
        Description:
          type: string
        Address:
          $ref: '#/components/schemas/ApiIntegratorLocationAddressResource'
        TimeZone:
          type: string
        LegalName:
          type: string
        Directions:
          type: string
        Geo:
          $ref: '#/components/schemas/ApiIntegratorLocationGeoResource'
        UniqueReference:
          type: string
        Acreage:
          type: number
          format: double
        IsDeleted:
          type: boolean
        GUID:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
    ApiIntegratorListItemResource:
      type: object
      properties:
        Description:
          type: string
        Guid:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000