# System

## Get system time

 - [GET /v1/system/time](https://developers.bcb.bm/apis/open-banking-api/open-banking-api/system/system_getsystemtime.md): Returns the current server date and time in ISO-8601 format. 
This endpoint helps integrators synchronize with the server clock and craft valid date/time windows for other API requests.

The response contains two fields:
1. timestamp – Current Bermuda local time in ISO-8601 format with the correct offset (e.g., 2025-01-07T14:30:15-04:00).
2. timeZone  – Display name of the time zone currently in effect ("Atlantic Daylight Time" or "Atlantic Standard Time").
            
This allows clients to know both the precise instant and whether Daylight-Saving Time is observed.

### Content Negotiation
Clients must use the HTTP Accept header to indicate the desired response format:
- Set Accept: application/json for JSON responses (default)
If the Accept header is omitted, application/json is assumed.

### Base URL:
All API requests use the versioned base URL:

    https://api.bcb.bm/v1/system/time

### Sample Request in JavaScript:

javascript
async function getSystemTime() {
  try {
    const response = await fetch('https://api.bcb.bm/v1/system/time', {
      method: 'GET',
      headers: {
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
        'Content-Type': 'application/json',
        'Accept': 'application/json'
      }
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(Error: ${errorData.message || 'Unknown error'});
    }

    const data = await response.json();
    console.log('Server timestamp (Bermuda time UTC-4):', data.timestamp);

    return data;
  } catch (error) {
    console.error('There was a problem retrieving system time:', error.message);
  }
}

// Example usage:
getSystemTime();