Birthstones API - Dart/Flutter Client

Birthstones is a comprehensive lookup API for birthstone information. It returns detailed data about gemstones associated with each birth month, including the primary stone, alternate stones, colors, meanings, and zodiac associations.

This is the Dart/Flutter client for the Birthstones API.

Installation

Add this to your pubspec.yaml:

dependencies:
  apiverve_birthstones: ^1.1.14

Then run:

dart pub get
# or for Flutter
flutter pub get

Usage

import 'package:apiverve_birthstones/apiverve_birthstones.dart';

void main() async {
  final client = BirthstonesClient('YOUR_API_KEY');

  try {
    final response = await client.execute({
      'month': '5'
    });

    print('Status: ${response.status}');
    print('Data: ${response.data}');
  } catch (e) {
    print('Error: $e');
  }
}

Response

{
  "status": "ok",
  "error": null,
  "data": {
    "month": 5,
    "monthName": "May",
    "primaryStone": "Emerald",
    "alternateStones": [
      "Chrysoprase",
      "Agate"
    ],
    "color": "Green",
    "meaning": "Rebirth, love, fertility",
    "zodiacSigns": [
      "Taurus",
      "Gemini"
    ],
    "hardness": 7.5,
    "mineralFamily": "Beryl",
    "anniversaryYear": 55
  }
}

API Reference

• API Home: Birthstones API
• Documentation: docs.apiverve.com/ref/birthstones

Authentication

All requests require an API key. Get yours at apiverve.com.

License

MIT License - see LICENSE for details.

Built with Dart for APIVerve