Solarware API Docs
Download YAML

List emails

Provide exactly one of contacts_id or partners_id.

get /api/v1/emails

Security

ApiKeyAuth

Parameters

Name In Type Details
contacts_id query integer optional
partners_id query integer optional

Responses

200 Email list

application/json

{
    "allOf": [
        {
            "title": "API envelope",
            "type": "object",
            "properties": {
                "success": {
                    "type": "boolean"
                },
                "message": {
                    "type": "string",
                    "nullable": true
                },
                "errors": {
                    "nullable": true
                },
                "meta": {
                    "type": "object",
                    "nullable": true,
                    "additionalProperties": true
                }
            }
        },
        {
            "type": "object",
            "properties": {
                "data": {
                    "type": "array",
                    "items": {
                        "title": "Email",
                        "type": "object",
                        "description": "Email in responses.",
                        "required": [
                            "email",
                            "is_primary"
                        ],
                        "properties": {
                            "id": {
                                "type": "integer",
                                "nullable": true
                            },
                            "contacts_id": {
                                "type": "integer",
                                "nullable": true
                            },
                            "partners_id": {
                                "type": "integer",
                                "nullable": true
                            },
                            "label": {
                                "type": "string",
                                "nullable": true
                            },
                            "email": {
                                "type": "string",
                                "format": "email"
                            },
                            "is_primary": {
                                "type": "boolean"
                            }
                        }
                    }
                }
            }
        }
    ]
}
401 Missing or invalid API key

application/json

{
    "type": "object",
    "properties": {
        "success": {
            "type": "boolean",
            "example": false
        },
        "message": {
            "type": "string",
            "example": "Missing API key (X-Api-Key)"
        }
    }
}
404 Resource not found

application/json

{
    "title": "API envelope",
    "type": "object",
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string",
            "nullable": true
        },
        "errors": {
            "nullable": true
        },
        "meta": {
            "type": "object",
            "nullable": true,
            "additionalProperties": true
        }
    }
}
422 Validation failed

application/json

{
    "title": "API envelope",
    "type": "object",
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string",
            "nullable": true
        },
        "errors": {
            "nullable": true
        },
        "meta": {
            "type": "object",
            "nullable": true,
            "additionalProperties": true
        }
    }
}