# Data Types

Learn about the different data types used by FusionAuth.

> For the index of this section of the site, see [llms.txt](https://fusionauth.io/docs/llms.txt)

## COSE Algorithm Identifiers

The WebAuthn specification uses COSE Algorithm Identifiers to specify which signing algorithms are allowed for new WebAuthn passkeys during registration and also the signing algorithm that a given passkey is using. These identifier values are defined by the [IANA COSE Algorithms registry](https://www.iana.org/assignments/cose/cose.xhtml). FusionAuth supports a subset of these algorithms.

*Supported algorithms*

| Name | Value | Description |
| --- | --- | --- |
| RS256 | \-257 | RSASSA-PKCS1-v1\_5 using SHA-256 |
| RS384 | \-258 | RSASSA-PKCS1-v1\_5 using SHA-384 |
| RS512 | \-259 | RSASSA-PKCS1-v1\_5 using SHA-512 |
| PS256 | \-37 | RSASSA-PSS w/ SHA-256 |
| PS384 | \-38 | RSASSA-PSS w/ SHA-384 |
| PS512 | \-39 | RSASSA-PSS w/ SHA-512 |
| ES256 | \-7 | ECDSA w/ SHA-256 |
| ES384 | \-35 | ECDSA w/ SHA-384 |
| ES512 | \-36 | ECDSA w/ SHA-512 |

## Instants

FusionAuth stores all time references as the number of milliseconds since the [unix epoch](#unix-epoch). This is is the same as [unix time](#unix-time) except the precision is milliseconds instead of seconds.

For example, consider the following date.

> 10:45 AM MST on July 4th, 2015

In order to send this value to FusionAuth, you would need to convert this date time to the number of milliseconds since the [unix epoch](#unix-epoch) which is `1436028300000` and then send this value as an input parameter. [Convert instants to human readable dates or vice versa.](https://fusionauth.io/dev-tools/date-time.md)

When you retrieve these same values from FusionAuth you may then easily convert the value to any date and time format you wish with as much or little precision as you wish. For example, you may display only the day, month and year to the user, or include hours and minutes, but excludes the seconds. Because everything we store is in UTC - converting this value to a local time zone is easy and there is no guess work.

## Locales

FusionAuth accepts and returns Locales on the API using the Java standard format of a ISO 639-1 two letter language code followed by an optional underscore and a ISO 3166-1 alpha-2 country code. Below is a table of common language and country codes and the resulting locale string that can either be sent into an API or be expected on the API response. This is not an exhaustive list but only provided as an example.

*Locale Codes*

| Language | Country | Locale |
| --- | --- | --- |
| Arabic | – | `ar` |
| Danish | – | `da` |
| German | – | `de` |
| English | – | `en` |
| Spanish | – | `es` |
| Spanish | Mexico | `es_MX` |
| Finish | – | `fi` |
| French | – | `fr` |
| Italian | – | `it` |
| Japanese | – | `ja` |
| Korean | – | `ko` |
| Dutch | – | `nl` |
| Norwegian | – | `no` |
| Polish | – | `pl` |
| Portuguese | – | `pt` |
| Russian | – | `ru` |
| Swedish | – | `sv` |
| Chinese | Taiwan | `zh_TW` |
| Chinese | China | `zh_CN` |

## Time Zone

FusionAuth accepts time zones in an [IANA](https://www.iana.org/time-zones) time zone format.

For example, the following values are all valid time zone formats.

*   `America/Chicago`
*   `America/Denver`
*   `America/New_York`
*   `Asia/Tel_Aviv`
*   `Asia/Tokyo`
*   `Europe/Amsterdam`
*   `Europe/Belfast`
*   `Europe/Kiev`
*   `Europe/Paris`
*   `Pacific/Tahiti`
*   `US/Central`
*   `US/Pacific`
*   `US/Mountain`
*   `US/Eastern`
*   `UTC-7`
*   `UTC+2`

## UUIDs

Data types specified as UUID are expected to be in a valid string representation of a universally unique identifier (UUID). The API specifically expects the UUID to be provided in its canonical form which is represented by 32 lowercase hexadecimal digits displayed in five groups separated by hyphens.

This representation takes the form of 8-4-4-4-12 for a total of 36 characters, 32 hexadecimal characters and four hyphens. In case you are converting an array of bytes, the break down of bytes for the hexadecimal String is 4-2-2-2-6. UUIDs are version 4.

Here's an example of a UUID in the expected canonical string format in a JSON request or response body.

```json
{
  "foo": {
    "id": "965865ef-b17d-4153-b952-d8902e584f7d"
  }
}
```

Here's an example of a UUID being provided as a URL segment for an API.

```plaintext
/api/user/965865ef-b17d-4153-b952-d8902e584f7d
```

Now that you're all excited about UUIDs, do you want to generate you own? Go ahead, we won't tell anyone - check out our ad-free [Online UUID generator](https://fusionauth.io/dev-tools/uuid-generator.md).

## Unix time

Unix time is the number of seconds since the [unix epoch](#unix-epoch).

You'll mostly find unix time used in token claims because that is what the specification requires.

### Unix epoch

An epoch is simply a fixed point in time used as reference point from which we can measure things. The unix epoch is `1 January 1970 00:00:00 UTC`.

You can pronounce epoch however you wish, we're not the boss of you, but common pronunciations include ee-pok as well as eh-pock.

Related

[APIs Complete a WebAuthn Passkey Assertion API API documentation for the FusionAuth Complete a WebAuthn Passkey Assertion API. webauthn](https://fusionauth.io/docs/apis/webauthn/complete-a-webauthn-passkey-assertion.md)

[APIs Complete a WebAuthn Passkey Authentication API API documentation for the FusionAuth Complete a WebAuthn Passkey Authentication API. webauthn](https://fusionauth.io/docs/apis/webauthn/complete-a-webauthn-passkey-authentication.md)

[APIs Complete a WebAuthn Passkey Registration API API documentation for the FusionAuth Complete a WebAuthn Passkey Registration API. webauthn](https://fusionauth.io/docs/apis/webauthn/complete-a-webauthn-passkey-registration.md)

[APIs Delete a Passkey API API documentation for the FusionAuth Delete a Passkey API. webauthn](https://fusionauth.io/docs/apis/webauthn/delete-a-passkey.md)
---

## Other pages in Apis

> For the full index of this section, see [Apis](https://fusionauth.io/docs/llms-apis.txt).

- [User Action API](https://fusionauth.io/docs/apis/actioning-users.md): Learn about the APIs for invoking a User Action on a User.
- [API Endpoints Guarded by API Keys](https://fusionauth.io/docs/apis/api-key-endpoints.md): A complete reference of all Fusionauth REST API Endpoints that leverage API Keys with their supported HTTP methods.
- [API Keys API](https://fusionauth.io/docs/apis/api-keys.md): Learn about the APIs for creating, retrieving, updating and deleting API Keys.
- [Application API](https://fusionauth.io/docs/apis/applications.md): Learn about the APIs for creating, retrieving, updating and deleting Applications.
- [Audit Log API](https://fusionauth.io/docs/apis/audit-logs.md): Learn about the APIs for adding entries to, searching, and exporting the audit log.
- [Authenticate with our APIs](https://fusionauth.io/docs/apis/authentication.md): Learn how the FusionAuth APIs authenticate requests.
- [CIMD Client Registration API](https://fusionauth.io/docs/apis/cimd-client-registrations.md): Learn about the APIs for retrieving, searching for, and deleting CIMD client registrations.
- [CIMD Domain OAuth Scopes API](https://fusionauth.io/docs/apis/cimd-domain-scopes.md): Learn about the APIs for creating, retrieving, updating and deleting the custom OAuth scopes of a CIMD domain.
- [CIMD Domain API](https://fusionauth.io/docs/apis/cimd-domains.md): Learn about the APIs for creating, retrieving, updating and deleting CIMD domains.
- [Configure CORS](https://fusionauth.io/docs/apis/configure-cors.md): How to set up and use the FusionAuth API Explorer.
- [Connector API](https://fusionauth.io/docs/apis/connectors.md): Learn about the APIs for creating, retrieving, updating and deleting identity providers.
- [Consent API](https://fusionauth.io/docs/apis/consents.md): Learn about the APIs for creating, retrieving, updating and deleting consents.
- [Email API](https://fusionauth.io/docs/apis/emails.md): Learn about the APIs for creating, retrieving, updating and deleting email templates as well as sending emails to users.
- [Entity API](https://fusionauth.io/docs/apis/entities.md): Learn about the APIs for creating, retrieving, updating and deleting entities and entity types.
- [Error Responses](https://fusionauth.io/docs/apis/errors.md): Learn about the error response that is returned from FusionAuth APIs.
- [Event Log API](https://fusionauth.io/docs/apis/event-logs.md): Learn about the APIs for searching and retrieving event logs.
- [Family API](https://fusionauth.io/docs/apis/families.md): Learn about the APIs for creating, retrieving, updating and deleting families.
- [Group API](https://fusionauth.io/docs/apis/groups.md): Learn about the APIs for creating, retrieving, updating and deleting groups.
- [Hosted Backend API](https://fusionauth.io/docs/apis/hosted-backend.md): Learn about the APIs that you to perform OAuth2 Authorization Code Flow login, logout, and refresh for applications.
- [Identity Provider API](https://fusionauth.io/docs/apis/identity-providers.md): Learn about the APIs for creating, retrieving, updating and deleting identity providers.
- [Identity Verify API](https://fusionauth.io/docs/apis/identity-verify.md): Learn about the APIs for starting, sending, and completing identity verification.
- [Integration API](https://fusionauth.io/docs/apis/integrations.md): Learn about the APIs for retrieving and updating integrations.
- [IP Access Control List API](https://fusionauth.io/docs/apis/ip-acl.md): Learn about the APIs for creating, retrieving, updating and deleting IP Access Control Lists.
- [JWTs & Refresh Token API](https://fusionauth.io/docs/apis/jwt.md): Learn about the APIs that allow you to manage Refresh Tokens, verify Access Tokens and retrieve public keys used for verifying JWT signatures.
- [Key API](https://fusionauth.io/docs/apis/keys.md): Learn about the APIs for generating, importing, retrieving, updating and deleting keys.
- [Lambda API](https://fusionauth.io/docs/apis/lambdas.md): Learn about the APIs for creating, retrieving, updating and deleting lambdas.
- [Login API](https://fusionauth.io/docs/apis/login.md): API documentation for the FusionAuth Login API.
- [Message Template API](https://fusionauth.io/docs/apis/message-templates.md): Learn about the APIs for creating, retrieving, updating and deleting message templates.
- [Messenger API](https://fusionauth.io/docs/apis/messengers.md): Learn about the APIs for creating, retrieving, updating and deleting messengers.
- [OAuth2 API](https://fusionauth.io/docs/apis/oauth.md): API documentation for the FusionAuth OAuth 2.0 and OpenID Connect endpoints.
- [OpenAPI Specification](https://fusionauth.io/docs/apis/openapi.md): Learn about the FusionAuth OpenAPI Specification, which allows you to use OpenAPI tooling to interact with FusionAuth.
- [Passwordless API](https://fusionauth.io/docs/apis/passwordless.md): Learn about the APIs for one-time password authentication.
- [Reactor API](https://fusionauth.io/docs/apis/reactor.md): Learn about the APIs for activating, deactivating, and retrieving the status of a FusionAuth Reactor license.
- [User Registration API](https://fusionauth.io/docs/apis/registrations.md): Learn about the APIs for creating, retrieving, updating and deleting User Registrations.
- [Report API](https://fusionauth.io/docs/apis/reports.md): Learn about the APIs for retrieving reports from FusionAuth.
- [SCIM API](https://fusionauth.io/docs/apis/scim.md): Learn about the APIs for provisioning SCIM Resources in FusionAuth using a SCIM Client.
- [OAuth Scopes API](https://fusionauth.io/docs/apis/scopes.md): Learn about the APIs for creating, retrieving, updating and deleting OAuth scopes.
- [System API](https://fusionauth.io/docs/apis/system.md): Learn about the APIs for retrieving and updating the system configuration.
- [Tenant Manager API](https://fusionauth.io/docs/apis/tenant-manager.md): Learn about the APIs for retrieving and updating Tenant Manager configuration.
- [Tenants API](https://fusionauth.io/docs/apis/tenants.md): Learn about the APIs for creating, retrieving, updating and deleting tenants.
- [Multi-Factor API](https://fusionauth.io/docs/apis/two-factor.md): Learn about the APIs for enabling and disabling multi-factor authentication for users.
- [User Action Reason API](https://fusionauth.io/docs/apis/user-action-reasons.md): Learn about the APIs for creating, retrieving, updating and deleting user action reasons.
- [Manage User Action API](https://fusionauth.io/docs/apis/user-actions.md): Learn about the APIs for creating, retrieving, updating and deleting user actions.
- [User Comment API](https://fusionauth.io/docs/apis/user-comments.md): Learn about the APIs for creating and retrieving comments on users.
- [User API](https://fusionauth.io/docs/apis/users.md): Learn how to integrate with the FusionAuth User API. This documentation provides a comprehensive reference for managing users.
- [WebAuthn API](https://fusionauth.io/docs/apis/webauthn.md): Learn about the APIs for starting and completing WebAuthn ceremonies and retrieving, importing and deleting WebAuthn passkeys.
- [Webhook Event Log API](https://fusionauth.io/docs/apis/webhook-event-logs.md): Learn about the APIs for searching and retrieving webhook event and attempt logs.
- [Webhook API](https://fusionauth.io/docs/apis/webhooks.md): Learn about the APIs for creating, retrieving, updating and deleting Webhooks.