Skip to main content
GET
/
v3
/
style_rules
Retrieve style rule lists
curl --request GET \
  --url https://api.deepl.com/v3/style_rules \
  --header 'Authorization: <api-key>'
{
  "style_rules": [
    {
      "style_id": "bd0a38f3-1831-440b-a8dd-2c702e2325ab",
      "name": "<string>",
      "creation_time": "2023-11-07T05:31:56Z",
      "updated_time": "2023-11-07T05:31:56Z",
      "language": "de",
      "version": 13,
      "configured_rules": [
        {
          "dates_and_times": {
            "calendar_era": "use_bc_and_ad",
            "centuries": "spell_out",
            "date_format": "use_dd_period_mm_period_yy_with_leading_zeros_for_single_digit_days_and_months",
            "dates_in_numerical_form": "use_dd_hyphen_mm_hyphen_yyyy",
            "decades": "spell_out",
            "hours_minutes_seconds_separator": "use_colon",
            "hours_minutes_separator": "use_colon_without_spaces",
            "midnight_in_numerals": "use_00_00",
            "single_digit_days_and_months": "do_not_use_leading_zero",
            "single_digit_hours": "do_not_use_leading_zero",
            "time_format": "spell_out_time_in_words",
            "writing_dates": "use_dd_space_spelled_out_month_space_yyyy",
            "years": "use_apostrophe_yy"
          },
          "formatting": {
            "email_address_format": "place_domain_in_parentheses",
            "email_address_website_url": "use_lowercase_for_email_addresses_and_website_urls_except_when_url_includes_case_sensitive_elements",
            "headings_case_style": "use_sentence_case_for_titles_and_headings",
            "phone_number_country_code_format": "use_00_before_country_code",
            "phone_number_format": "do_not_use_spaces",
            "space_between_arabic_numerals_and_unit": "do_not_use",
            "space_between_chinese_and_english": "do_not_use",
            "space_between_chinese_characters_and_arabic_numerals": "do_not_use",
            "titles_headings_punctuation": "do_not_use_colon_at_end_of_titles_or_headings"
          },
          "numbers": {
            "approximate_numbers": "use_kanji_numbers",
            "currency_format": "spell_out",
            "decimal_numbers_less_than_one": "always_use_0_before_decimal_separator",
            "decimal_separator": "use_comma_and_do_not_use_thousands_separator",
            "dimensions_separator": "use_multiplication_sign_between_dimensions_with_space_on_either_side",
            "equation_formula_reference": "always_use_arabic_numerals_to_number_equations_or_formulas_referenced_in_text",
            "kanji_numbers": "use_kanji_numbers_for_numbers_in_phrases_and_counting_method_based_on_native_japanese_readings",
            "large_number_format": "always_use_arabic_numerals",
            "large_sums_of_money": "spell_out_italian_words_milione_and_miliardo",
            "large_sums_of_money_format": "use_amount_followed_by_abbreviation_for_million_or_billion_without_space",
            "list_of_measurements_with_units": "repeat_unit_for_each_measurement_in_list",
            "mathematical_expression_spacing": "use_space_between_elements_of_mathematical_expression_or_equation",
            "number_format": "use_half_width_comma_to_separate_large_numbers_into_units_of_three_except_for_calendar_years_and_use_half_width_period_as_decimal_separator",
            "number_separator": "do_not_use_chinese_comma_to_separate_numbers_indicating_approximate_value",
            "numbers_of_5_digits_or_more": "use_comma_as_decimal_separator_and_period_as_thousands_separator",
            "numbers_up_to_4_digits": "use_comma_as_decimal_separator_and_period_as_thousands_separator",
            "percentage_format": "use_arabic_numerals_followed_by_percent_symbol_without_space",
            "reference_to_symbol": "spell_out_symbol_name_followed_by_symbol_in_parentheses",
            "spelling_out_units": "abbreviate_units_of_measure_when_used_with_numeral_but_spell_out_when_used_without_numeral",
            "temperature_format": "spell_out_unit",
            "thousands_separator": "do_not_use",
            "units_of_measure_spacing": "do_not_use_space_between_numeral_and_unit_of_measure",
            "use_of_hiragana_and_kanji": "use_hiragana_japanese_word_か所_or_か月_when_using_arabic_numerals_in_horizontal_writing_but_use_kanji_japanese_word_箇所_or_箇月_when_using_kanji_numbers",
            "writing_numbers": "always_use_kanji_numbers",
            "zero_format": "use_chinese_word_〇_for_numbering"
          },
          "punctuation": {
            "abbreviations": "do_not_separate_abbreviated_words",
            "acronyms": "do_not_use_periods",
            "ampersand_abbreviation_spacing": "do_not_use_spaces_before_and_after_ampersand_as_part_of_abbreviation",
            "ampersand_usage": "use_english_word_and_except_in_company_names_common_abbreviations_titles_software_code_and_mathematical_equations",
            "apostrophe": "use_curly_apostrophes",
            "bracket": "use_hexagonal_brackets",
            "chinese_mixed_with_english": "do_not_place_english_in_quotation_marks",
            "colon": "use_full_width_colon",
            "colon_between_hours_and_minutes_or_chapters_and_verses": "do_not_use_space_before_or_after_colon",
            "colon_in_heading": "use_space_after_colon_not_before",
            "colon_to_replace_versus_or_to": "do_not_use_space_before_or_after_colon",
            "comma_after_conjunctive_adverbs": "do_not_use",
            "comma_after_i_e_and_e_g": "do_not_use",
            "comma_after_short_introductory_phrase": "do_not_use",
            "comma_and_semicolon": "use_comma_between_clauses",
            "corner_bracket_and_periods": "add_period_after_closing_corner_bracket_at_end_of_sentence",
            "corner_brackets_and_periods": "do_not_add_period_before_closing_corner_bracket_when_sentence_continues",
            "dash": "use_em_dash",
            "ellipsis": "use_ellipsis_character",
            "em_dash": "use_double_em_dash",
            "emphasis": "use_double_corner_brackets",
            "exclamation_marks": "do_not_use",
            "explanatory_note_indicator": "use_double_em_dash",
            "full_sentence_in_round_brackets": "add_period_before_closing_round_bracket",
            "highlighting_specific_expressions": "use_single_curly_quotation_marks",
            "japanese_reference_materials": "use_double_corner_brackets",
            "parentheses_for_supplementary_information": "use_parentheses_without_space_on_either_side",
            "passage_of_time_and_movement_between_locations": "use_double_em_dash",
            "periods_and_commas": "use_full_width_japanese_periods_and_full_width_japanese_commas",
            "periods_in_academic_degrees": "do_not_use",
            "periods_in_direct_quotes": "do_not_use",
            "periods_in_uppercase_initialisms_and_acronyms": "do_not_use",
            "plus_sign_usage": "do_not_use_plus_sign_to_symbolize_english_word_and_unless_it_is_part_of_a_proper_noun",
            "possessives_of_proper_names_ending_in_s_style": "add_apostrophe_only",
            "quotation_mark": "use_curly_quotation_marks",
            "quotation_mark_and_apostrophe": "use_curly_quotation_marks_and_apostrophes",
            "quotation_style": "use_corner_brackets_for_primary_quotations_and_double_corner_brackets_for_secondary_quotations",
            "range_indicator": "use_en_dash_with_spaces",
            "related_phrases_indicator": "use_comma",
            "round_brackets": "use_full_width_round_brackets",
            "salutation": "do_not_use_comma_after_salutation_capitalize_following_word",
            "sentence_break_indicator": "use_em_dash_with_space_on_either_side",
            "serial_comma": "do_not_use",
            "setting_off_non_quoted_phrases": "use_full_width_quotation_marks",
            "slash": "do_not_use_spaces_before_and_after_slashes",
            "slash_usage": "do_not_use_slash_to_symbolize_english_word_or",
            "spacing_and_punctuation": "do_not_use_space",
            "text_in_round_brackets_referring_to_previous_sentence": "add_period_after_closing_round_bracket",
            "text_in_round_brackets_supplementing_preceding_text": "add_period_after_closing_round_bracket",
            "titles_of_books_and_newspapers": "use_double_angle_brackets",
            "titles_of_creative_works_trade_names_laws_and_regulations": "use_single_angle_brackets",
            "uppercase_acronyms": "do_not_use_spaces"
          },
          "spelling_and_grammar": {
            "abbreviating_french_word_numero": "abbreviate_as_n_then_degree_symbol",
            "abbreviation_usage": "do_not_use_abbreviations",
            "accents_and_cedillas": "do_not_use_on_capital_letters",
            "accents_in_verbs_conjugated_like_french_word_céder": "use_acute_accent",
            "accents_with_subject_verb_inversion": "use_acute_accent",
            "active_passive_voice": "use_active_voice_if_subject_is_prominent_and_agent_is_clear",
            "all_caps": "do_not_use_all_caps_except_for_acronyms_initialisms_or_proper_nouns",
            "complete_sentences": "always_write_complete_sentences",
            "compound_nouns": "write_as_one_word",
            "conjunctions": "never_start_sentence_with_coordinating_conjunction",
            "contractions": "do_not_use_contractions",
            "email_address_website_url": "use_lowercase_for_email_addresses_and_website_urls_except_when_url_includes_case_sensitive_elements",
            "established_loanwords": "use_as_is",
            "eszett": "replace_eszett_with_ss",
            "foreign_word_translation": "use_equivalent_expressions_in_chinese",
            "french_verbs_ending_in_eler_and_eter": "transcribe_open_e_sound_by_doubling_next_consonant",
            "i_and_u_with_circumflex_accents": "do_not_use_circumflex_accents_except_in_verbs_and_to_distinguish_homophones",
            "informal_address_pronouns": "capitalize_informal_address_pronouns",
            "latin_abbreviations": "do_not_use_latin_abbreviations",
            "passive_voice": "avoid_passive_voice_when_agent_is_known",
            "past_participle_of_french_word_laisser_followed_by_infinitive": "make_french_word_laisser_agree_with_direct_object_complement_if_it_appears_before_verb",
            "personal_titles": "abbreviate",
            "pluralizing_foreign_words": "use_french_spelling_rules",
            "quotation_modification": "do_not_modify_text_in_quotation_marks",
            "spanish_word_solo": "never_use_acute_accent",
            "special_characters": "never_use_symbols",
            "spelled_out_numbers": "use_hyphens",
            "umlauts": "replace_umlauts_with_ae_oe_ue",
            "unestablished_loanwords": "paraphrase_in_korean"
          },
          "style_and_tone": {
            "abbreviations": "avoid_abbreviations_and_symbols_that_can_be_spelled_out_easily",
            "addressing_non_binary_people": "use_spanish_word_elle",
            "addressing_the_reader": "use_formal_french_word_vous",
            "anglicisms": "avoid_anglicisms_when_there_is_a_french_equivalent",
            "binary_representation_of_gender": "avoid_binary_representation_of_gender_when_gender_neutral_language_can_be_used",
            "call_to_action": "use_calls_to_action",
            "complex_sentences": "avoid_unnecessarily_complex_sentences",
            "country_names": "use_long_form",
            "declarative_endings": "mix_hapsho_and_haeyo_styles",
            "default_first_person_pronoun": "do_not_use_first_person_pronouns",
            "default_second_person_pronoun": "do_not_use_second_person_pronouns",
            "default_third_person_singular_pronoun": "use_feminine_pronoun",
            "directional_language": "do_not_use_directional_language",
            "double_negatives": "do_not_use_double_negatives",
            "formality": "use_casual_tone",
            "gender_neutral_language_readability": "use_generic_masculine_for_common_compound_nouns_if_it_increases_readability",
            "gender_unspecified": "use_both_masculine_and_feminine_forms",
            "gender_unspecified_or_mixed": "use_both_feminine_and_masculine_forms",
            "idioms_colloquialisms_and_culture_specific_references": "do_not_use",
            "inflected_words_masculine_noun_agreement": "place_masculine_nouns_closest_to_inflected_words",
            "instructions_style": "use_imperative",
            "mixing_styles": "do_not_mix_desu_masu_style_and_dearu_style",
            "modal_verbs": "avoid_modal_verbs",
            "person_vs_identity_first_language": "use_identity_first_language",
            "personal_vs_impersonal_style": "use_impersonal_style",
            "positive_vs_negative_language": "use_positive_language",
            "proximity_agreement": "use",
            "reader_action_required": "use_you_must_when_action_is_required_from_reader",
            "redundant_introductory_phrases": "avoid_redundant_introductory_phrases",
            "redundant_phrases": "avoid_relativizing_and_redundant_phrases",
            "referring_to_non_binary_people": "use_the_singular_and_plural_schwa",
            "short_vs_long_words": "use_short_words",
            "simple_words_and_sentences": "use_simple_words_and_sentences_avoid_hard_to_translate_words_and_figures_of_speech",
            "specialized_language": "avoid_specialized_language_unless_text_is_aimed_at_experts",
            "text_position_references": "avoid_directional_terms_as_only_reference_to_position_in_text_specify_exact_position_instead",
            "tone": "use_dearu_style_to_give_impression_content_is_accurate_and_rigorous_or_to_convey_sense_of_confidence_and_reliability",
            "verbal_vs_nominal_style": "use_nominal_style"
          },
          "vocabulary": {
            "abbreviations": "write_original_term_then_abbreviation_and_explanation",
            "loanwords": "add_explanation_to_loanword_if_difficult_to_rephrase"
          }
        }
      ],
      "custom_instructions": [
        {
          "label": "Currency custom instruction",
          "prompt": "Have currency symbols before the numerical value (e.g. $100, €100)",
          "source_language": "en"
        }
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

Authentication with Authorization header and DeepL-Auth-Key authentication scheme. Example: DeepL-Auth-Key <api-key>

Query Parameters

page
integer
default:0

The index of the first page to return. Use with page_size to get the next page of rule lists

page_size
integer
default:10

The maximum number of style rule lists to return.

Required range: 1 <= x <= 25
detailed
boolean
default:false

Determines if the rule list's configured_rules and custom_instructions should be included in the response body.

Response

JSON object containing the style rule lists.

style_rules
object[]