Get your account
Gets your account. Use me so you do not need to know the account ID. You can only read the account your token belongs to (403 for any other).
The account is not split by mode, so this needs a live token. A test token gets 400 with the code token_type_mismatch.
Live secret and trusted tokens may call this with the accounts read permission.
AuthorizationBearer <token>A secret, trusted or limited token. See Authentication.
account_id*stringYour account ID, or me for the account of the token you call with.
expand?stringComma-separated child objects to return in full instead of as a URL, for example customer,payments. Use dot notation for nested objects (items.product), up to four levels deep. A single object takes up to 12 paths; a list takes up to 2, applied to every item. Extra paths are dropped without an error. See Expanding objects.
formatted?booleanWhen true, the object also has a formatted child with amounts and dates as display text in the shopper's language and currency (for example $19.99 or November 7, 2026). The default is false. See Localized formatting.
falseshow?stringComma-separated fields to return; all others are left out. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.
hide?stringComma-separated fields to leave out of the response. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.
timezone?stringAn IANA time zone name, such as America/New_York or UTC. It sets how date_start and date_end are read and the time zone of every date in the response. The default is the account's time zone (Settings, Technical), or UTC when it has none. A name that is not known is a 400.
The account.
application/json- response
Your Comecero account: your company details, the contact details shoppers see, and whether the account may take live payments. One account holds both your test and your live data.
object?"account"The object type. Always account.
"account"url?stringThe URL of this account.
uriaccount_id?stringThe account ID, two letters and four digits.
alias?|A short name for the account that users may sign in with instead of the account ID. It is also the start of your sign-in page address.
date_created?stringWhen the account was created.
date-timedate_modified?stringWhen the account was last changed.
date-timecompany_name?|The legal name of your company.
length <= 75dba?|The name you trade under, if it differs from company_name.
length <= 75name?|The full name of the main contact.
length <= 75email?|The main contact's email address.
emaillength <= 75website?|Your website. https:// is added when you leave out the protocol.
length <= 75phone?|Your phone number.
length <= 25tax_number?|Your VAT or tax registration number, printed on invoices. In the EU an invoice needs it.
length <= 50registration_number?|Your company registration number.
length <= 50logo_url?|A public https URL of your logo, used on invoices and emails. Up to 500 characters.
urilength <= 500address_1?|The first line of your address.
length <= 75address_2?|The second line of your address.
length <= 75city?|Your city.
length <= 75state_prov?|Your state or province. For the US and Canada, the standard two-letter code.
length <= 75postal_code?|Your postal code.
length <= 75country?|Your country, as an ISO 3166-1 alpha-2 code.
support_email?|The email address shoppers see for help. Null when you want none shown on your shop.
emaillength <= 75support_website?|The support page shoppers see. When it is empty, website is used.
length <= 75live?booleanTrue when the account may take live payments. New accounts start with false and Comecero sets it once the account is approved.
closed?booleanTrue when the account has been closed.
date_closed?|When the account was closed. Null for an open account.
date-timeaccount_meta?|The account's meta details, as a URL, or the object when you send expand=account_meta.
token?stringA live trusted token for the account owner, so they are signed in at once. Only in the response to POST /accounts.
formatted?Display text for dates and the country. Only present when you send formatted=true.
curl -X GET 'https://api.comecero.com/api/v1/accounts/me'{ "object": "account", "url": "https://api.comecero.com/api/v1/accounts/AB1234", "account_id": "AB1234", "alias": "example-shop", "date_created": "2026-03-01T14:36:52Z", "date_modified": "2026-10-01T09:20:11Z", "company_name": "Example Software Ltd", "dba": "Example Software", "name": "John Doe", "email": "john@example.com", "website": "https://www.example.com", "phone": "+1 555 0100", "tax_number": null, "registration_number": null, "logo_url": "https://www.example.com/logo.png", "address_1": "100 Main Street", "address_2": null, "city": "Springfield", "state_prov": "IL", "postal_code": "62701", "country": "US", "support_email": "support@example.com", "support_website": "https://www.example.com/support", "live": true, "closed": false, "date_closed": null, "account_meta": "https://api.comecero.com/api/v1/accounts/AB1234/account_meta"}Sign up for an account POST
Creates a new Comecero account with its first user, who becomes the account owner. This is how someone signs up, so it needs no token. The response has a live trusted `token` for the owner, so they are signed in at once. The new account is not live: it can take test payments right away, and Comecero sets `live` once the account is approved. Default settings, a test gateway and a shipping method for the account's country are created with it.
Update your account POST
Changes your company and contact details or your alias. Only the fields you send change. `live` and `closed` are set by Comecero and are ignored here. Fires the `account:modified` event. This needs a live token: a test token gets `400` with the code `token_type_mismatch`. Live secret and trusted tokens may call this with the `accounts` update permission.